Metadata-Version: 2.4
Name: delos-cli
Version: 1.0.0
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.12
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: ==3.12.*
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: 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
/delete               delete the current chat and go back to the picker
/resume               back to the picker without deleting
/stop                 interrupt the agent
/quit                 exit
```

## 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.12
- A [Delos](https://delos.so) account

## Uninstall

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

---

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