Metadata-Version: 2.4
Name: tuva
Version: 0.1.3
Summary: Tuva CLI — terminal interface to the Tuva daemon
Project-URL: Homepage, https://tuva.ai
Project-URL: Repository, https://github.com/Tuva-ai/entropy
Author: Tuva AI
License: Proprietary
Keywords: ai,research,tuva
Requires-Python: >=3.10
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Requires-Dist: websockets>=14
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# tuva — Tuva CLI

Terminal interface to the Tuva daemon. Speaks the same protocol the VS Code
extension uses.

## Install (dev)

```bash
pipx install -e ./cli
tuva --version
```

## Commands

| Command | Purpose |
|---|---|
| `tuva start` / `tuva stop` | Bring the daemon up / down (idempotent) |
| `tuva status` | Show daemon health + ports (`--json` for scripts) |
| `tuva restart` | Stop + start |
| `tuva logs [-f]` | Tail `backend.log` |
| `tuva chat` | Interactive chat REPL against the daemon |
| `tuva init [<dir>]` | Initialize a project (`.project` file); local, no daemon needed |
| `tuva index <dir>` | Register + index a workspace for knowledge search |
| `tuva workspaces list/forget` | Inspect / drop registered workspaces |

For the full startup walkthrough (backend venv, `TUVA_REPO_ROOT`, local-mode keys, idle behavior,
troubleshooting), see **Section 5 of the root [`README.md`](../README.md)**.

`tuva auth login/logout/whoami` (cloud-mode credentials) and `tuva mcp configure {claude,codex,cursor}`
are planned per `docs/design-standalone-daemon.md` and not yet shipped.

## Run tests

```bash
cd cli
pip install -e '.[dev]'
pytest
```
