Metadata-Version: 2.5
Name: delos-cli
Version: 5.9.22
Summary: Terminal REPL for the Delos agent — the Claude-Code-style CLI for Delos.
Project-URL: Homepage, https://delos.so
Project-URL: Repository, https://github.com/Delos-Intelligence/cosmos-saas
Project-URL: Issues, https://github.com/Delos-Intelligence/cosmos-saas/issues
Author: Delos Intelligence
License: MIT
Keywords: agent,ai,chat,cli,delos,repl,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: ==3.14.*
Requires-Dist: httpx>=0.27.0
Requires-Dist: prompt-toolkit>=3.0.47
Requires-Dist: questionary>=2.0.1
Requires-Dist: rich>=13.8.0
Requires-Dist: ripgrep<15,>=14; sys_platform == 'darwin'
Requires-Dist: ripgrep<15,>=14; sys_platform == 'linux' and (platform_machine == 'x86_64' or platform_machine == 'aarch64')
Requires-Dist: ripgrep<15,>=14; sys_platform == 'win32' and (platform_machine == 'AMD64' or platform_machine == 'x86_64')
Requires-Dist: sentry-sdk<3,>=2.44.0
Requires-Dist: truststore>=0.10.0
Requires-Dist: typer>=0.12.5
Description-Content-Type: text/markdown

# delos-cli

A terminal REPL for [Delos](https://delos.so) — the **Claude-Code-style CLI for the Delos agent**.

Talk to your Delos AI from any shell. Streaming Markdown answers, slash
commands, and tools that read and edit your local files (with your
approval), all in a TUI that lives in your terminal.

## Install

```bash
uv tool install delos-cli
```

Or with pipx:

```bash
pipx install delos-cli
```

## Sign in

```bash
delos login --region eu       # or "us" / "ae"
```

The browser opens, you sign in to your Delos workspace, and the CLI
saves your tokens to `~/.config/delos/`.

## Run

```bash
delos
```

Conversations are scoped to the directory you launch from — running
`delos` in `~/projects/foo` shows only chats started in
`~/projects/foo`. Pick an existing one to resume, or start a fresh one.

### In the REPL

| Action                    | Key                                                         |
| ------------------------- | ----------------------------------------------------------- |
| Send a message            | `Enter`                                                     |
| New line                  | `Alt+Enter`                                                 |
| Stop the agent mid-answer | `Esc` (or `/stop`)                                          |
| Quit                      | `Ctrl+D` (or `/quit`)                                       |
| Scroll                    | mouse wheel · `PageUp` / `PageDown` · `End` to follow again |

### Slash commands

```
/help                 list commands
/clear                wipe the screen and start a fresh conversation
/rename <new name>    rename the current chat
/mode [name]          show or set the mode: ask, plan, auto, build (default: build; shift-tab cycles)
/delete               delete the current chat and go back to the picker
/resume               back to the picker without deleting
/stop                 interrupt the agent
/usage                show plan usage limits and remaining credits
/context              show what fills the agent's context window
/quit                 exit
```

### Local MCP servers

The CLI runs the stdio MCP servers declared in a `.mcp.json` (the Claude Code
format) and gives their tools to the agent as `mcp__<server>__<tool>`. They
execute on your machine, after the same permission prompt as shell commands,
so keys stay local.

- global: `~/.config/delos/mcp.json`
- project: the nearest `.mcp.json` up to the repo root (wins on a name clash)

```json
{
  "mcpServers": {
    "my-server": {
      "command": "uvx",
      "args": ["my-mcp"],
      "env": { "TOKEN": "${MY_TOKEN}" },
      "timeout": 600
    }
  }
}
```

`timeout` is per call, in seconds. A project server only starts once you
approve it in `/mcp`, and again whenever its command, args or env change.
Server logs: `~/.config/delos/logs/mcp-<name>.log`.

### Remote MCP servers

A remote entry (`"type": "http"` with a `url`) is not run by the CLI: checking
it in `/mcp` imports it into Delos as your own connector (nobody else in the
org sees it), opens its OAuth consent in your browser, then enables it for
the coding agent. Its tools then run server-side, through Delos, like any
other connector. Not supported yet: entries with `headers`, and URLs only
your machine can reach (`localhost`, private addresses, `.local`).

`d` in `/mcp` (or "Remove from Delos" in VS Code) removes your own import
and your credential for it; the entry stays in `.mcp.json`, and checking it
again imports it afresh — the way out of an import that went wrong.

## Headless mode (VSCode extension engine)

```bash
delos serve --app vscode --workspace /path/to/project
```

Runs the agent as an NDJSON server over stdio — no TUI. This is what the
Delos Code VSCode extension spawns under the hood: user messages and RPC
requests come in on stdin, agent events / permission requests / RPC
responses go out on stdout (one JSON object per line), logs go to stderr.
See `apps/vscode/DEVELOPING.md` in the monorepo for the protocol reference.

## Requirements

- Python 3.14
- A [Delos](https://delos.so) account

## Uninstall

```bash
uv tool uninstall delos-cli
```

---

Made by [Delos Intelligence](https://delos.so).
