巧匠Developer Cheatsheet

OpenHands CLI Cheatsheet - Open-Source Autonomous Coding Agent Full Reference

OpenHands is an open-source autonomous coding agent for developers who want the AI to plan end-to-end and write complete functionality into a repo — even a whole repo. Unlike helpers that confirm every command, it emphasizes autonomous execution with approval/headless modes, suiting batch work (CI, benchmarks, large-scale refactors). This sheet covers launch, task execution, approval modes, headless, and MCP.

AI CLI·30 commands·Last updated 2026-08-21
openhandsaicliagentAutonomous AgentOpen Source

Launch & Task 5

openhands
Start the interactive TUI / Web (default port 3000)
openhands -t "Implement user auth"
Run directly with a task (--task)
openhands -f task.txt
Read the task from a file
openhands --always-approve
Auto-approve all actions (alias --yolo)
openhands --llm-approve
Auto-approve only LLM-initiated actions

Resume & Headless 5

openhands --resume
Resume the previous session
openhands --resume --last
Resume the most recent session
openhands --resume <id>
Resume a session by ID
openhands --headless -t "task"
Run a task in headless mode
openhands --headless --json
Headless JSON output (for scripts)

Run Modes (Web/ACP/Cloud) 5

openhands web
Start the Web UI
openhands serve
Run as a resident service
openhands acp
Expose via the ACP protocol
openhands login
Sign in to OpenHands Cloud
openhands cloud -t "task"
Submit a task to the cloud

MCP Management 5

openhands mcp list
List MCP servers
openhands mcp add tavily
Add an MCP server like tavily
openhands mcp enable <name>
Enable an MCP server
openhands mcp disable <name>
Disable an MCP server
openhands --from-issue <url>
Pull a task from an Issue URL

Config & Install 5

uv tool install openhands --python 3.12
Install the V1 CLI (recommended)
pip install openhands-ai==0.45.0
Install a pinned version via pip
docker pull openhands/runtime:0.45-cpu
Pull the runtime image
openhands --override-with-envs
Override config with env vars
cat ~/.openhands/config.toml
Inspect user config (core/llm/sandbox/planner)

Hotkeys 5

Ctrl+P
Open the command palette
Esc
Pause the current task
Ctrl+Q
Quit
/exit
Exit the session
openhands --max-iterations 50
Cap the maximum iteration count

Tips

  • OpenHands aims to "write a whole repo" autonomously — more aggressive than pair programming; for big tasks use `--resume` to keep checkpoints so a crash can continue.
  • For headless batch use `--headless --json` in pipelines, with `--max-iterations` to stop runaway loops.
  • Don't bare-run `--always-approve` on sensitive/prod tasks; at least use `--llm-approve` or validate small with `--headless` first.
  • Config lives in `~/.openhands/config.toml` (llm/sandbox/planner) — set model and sandbox policy once, no per-run flags.

Related Cheatsheets

6 related cheatsheets

Claude Code CLI Cheatsheet - Anthropic AI Coding Agent Full ReferenceFull command reference for Claude Code, Anthropic terminal AI coding agent: install & auth, -p print mode and session resume, --permission-mode/--worktree, dev slash commands, MCP server management, and @ file references, all flags matching official docs.Codex CLI Cheatsheet - OpenAI Terminal Coding Agent Full ReferenceCommand reference for OpenAI Codex CLI, the Rust-built terminal coding agent: install & auth, interactive and non-interactive codex exec, session management, model & config, sandbox and approval modes, MCP, and Codex Cloud.Gemini CLI Cheatsheet - Google Terminal AI Agent Full ReferenceCommand reference for Gemini CLI, Google open-source (Apache 2.0) terminal AI agent: install & auth, run modes and global flags, session slash commands, MCP/extension management, and GEMINI.md project memory, with a 2M context.Cursor Editor CLI Cheatsheet - AI Editor Command Line & Agent FlagsCommand-line and Cursor Agent reference for Cursor, the VS Code-based AI editor: opening files/folders, window management, diff compare, extension management, rendering & performance, remote dev, debugging, cursor-agent non-interactive calls, and git core.editor integration.Aider Cheatsheet - Open-Source Terminal AI Pair Programming Full ReferenceCommand reference for Aider, the open-source Apache 2.0 terminal AI pair programmer (100+ models, auto git commits): install, model & reasoning, files & context, chat modes, Git & run, session tools, and advanced usage.OpenCode CLI Cheatsheet - Open-Source TUI AI Coding Agent Full ReferenceCommand reference for OpenCode, the open-source Claude Code-style TUI terminal AI coding agent: launch & resume, CLI flags, session and subcommands (agent/auth/github/mcp/run/serve/web), and interactive slash commands.

Official References

Each command links to its official documentation below, so you can verify the latest usage and read deeper.

Maintained by LaoHand

Publicly updated on Aug 21, 2026, continuously proofread against official docs.

Contact Us

Wrong command or description? Send us corrections, business inquiries or product feedback by email.

Contact Us