MeghaOS ships a terminal companion: megha, a command-line tool that talks to the running agent at http://localhost:8000. It brings the agent’s brain to your shell, letting you ask questions, run AI-driven tasks, refactor code, scaffold repos, and open PRs without leaving the terminal.

​
Setup

The launcher adds the CLI to your PATH automatically. To use it in any shell, add it yourself:
The CLI requires the agent to be running (it POSTs to http://localhost:8000).

​
Commands

​
How it works

megha is a thin Bash client: each subcommand POSTs to the appropriate agent endpoint (e.g. /chat, /api/llm, /project/setup, /cli/dispatch) and prints the result. Because it hits the same backend as the desktop, anything the shell can do is reachable from the terminal, including the full tool catalog and workflows.

​
Repo setup

megha setup <git-url> (backed by bin/megha-setup and the project_setup plugin / /project/setup) sets up a repository and runs an AI-driven setup, detecting the stack, installing dependencies, and getting it ready to run. Optionally pass a target directory:

​
The /cli/dispatch endpoint

Commands route through the agent’s HTTP API, including POST /cli/dispatch for general command dispatch, so the CLI stays in lockstep with the desktop’s capabilities.
megha pairs naturally with Computer Control: use the CLI for quick, scriptable asks, and computer control when you want the agent to drive a GUI app or IDE.