# OpenHands CLI Guide

The former OpenHands terminal client, retained here for existing installations and migration research.

Canonical URL: https://aiidelist.com/blog/traeide-openhands-cli

Language: en

Published: 2026-10-03

Updated: 2026-10-03

> Editorial snapshot from September 2026. Prices, models and interface labels may change; this is a practical guide, not a live product feed.

The former OpenHands terminal client, retained here for existing installations and migration research.

**No longer actively maintained**

The official repository says this CLI is no longer actively maintained and recommends Agent Canvas.

Coding agent · OpenHands · macOS · Linux

 

## Suitable workflows

Maintaining an existing OpenHands CLI setup and understanding its configuration.

## Limitations and billing

The official repository says this CLI is no longer actively maintained and recommends Agent Canvas.

## Capabilities we verified

Agent workflow · CLI surface · MCP · Bring your own key

This is an evidence-based shortlist, not an exhaustive feature inventory. Omitted capabilities have not been checked for this record.

## Pricing & usage

**See official pricing**

Legacy client; configured provider and infrastructure costs. The cost of metered usage or an external agent can be separate from the subscription.

## Models & access

Configure the LLM provider supported by your installed version.

<span id="cli-setup"></span>

## Install and start the CLI

Legacy installation requires Python 3.12+ and uv 0.11.6+; check migration guidance before installing.

```
uv tool install openhands --python 3.12
```

Open your project folder in a terminal, then run:

```
openhands
```

## Account and authentication

The first-run wizard configures the LLM provider used by the existing client.

## Project configuration and tools

Settings live under ~/.openhands/. Environment overrides require --override-with-envs in the documented version.

## First task to try

Inspect an existing setup and its provider settings before deciding whether to migrate.

## Script usage

This example asks for a project summary. Tool permissions still apply; a prompt is not a sandbox.

```
openhands --headless -t "Summarize the project structure without modifying files."
```

## Related CLI tools

[All AI CLI tools →](/blog/traeide-coding-agents)

[goose](/blog/traeide-goose) — An open-source agent that connects model providers, MCP tools and repeatable recipes.

[OpenCode](/blog/traeide-opencode) — An open-source coding agent with a terminal UI and configurable model providers.

[Mistral Vibe](/blog/traeide-mistral-vibe) — Mistral’s coding agent for terminal sessions, scripts and configurable local or hosted models.

## Project evaluation checklist

1. Open a small, familiar project and confirm that your essential language tooling works.
2. Give the agent one bounded change with an observable acceptance criterion.
3. Review the diff, run the project’s checks and compare the result with your current workflow.
4. Inspect usage after the task. Estimate a month of similar work, including any separate model or agent bill.

## Related TRAE guides

- [TRAE product overview](/ide/trae)
- [Trae IDE / TraeCode Download](/blog/traeide-download)
- [TraeCode Guide](/blog/traeide-traecode)
- [TraeWork Guide](/blog/traeide-traework)
- [TRAE Pricing: TraeCode & TraeWork](/blog/traeide-pricing)
- [TRAE Models & Model Access](/blog/traeide-models)
- [TraeWork vs TraeCode (Trae IDE)](/blog/traeide-traework-vs-traecode)
- [Trae MCP Setup & Troubleshooting](/blog/traeide-mcp)