Metadata-Version: 2.4
Name: antahkarana-cli
Version: 0.1.0
Summary: ant — the Antaḥkaraṇa governed-AI operator CLI: prompt your on-box copilot to investigate/operate a machine, read-only by default, with y/N approval for changes and catastrophic commands hard-blocked.
Author: Deepak Soni
License: Apache-2.0
Project-URL: Homepage, https://pypi.org/project/antahkarana/
Keywords: llm,agent,cli,security,mcp,antahkarana,governed,ssh
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# ant — Antaḥkaraṇa governed-AI operator CLI

Author — Deepak Soni. A tiny, dependency-free CLI that prompts your **on-box copilot** (the Antaḥkaraṇa model +
control ring) from any terminal — Claude-Code style. It investigates a machine, reasons, runs **read-only**
commands immediately, and asks **y/N before any state-changing action**; catastrophic commands are hard-blocked
server-side.

## Install
```bash
pip install antahkarana-cli
```

## Use
```bash
ant connect http://YOUR-BOX:8090     # point it at your copilot (saved to ~/.ant/config.json)
ant                                  # interactive: banner + prompt
ant "what is listening on this server?"   # one-shot
ant status                           # connection + model health
```
In the REPL, slash commands: `/connect <url>` · `/login <token>` · `/model` · `/status` · `/clear` · `/exit`.

## What you can ask
- `what OS is this and what's listening on its ports?`  → runs read-only, reports
- `create a file /tmp/demo.txt`  → proposes it, asks **[y/N]**, runs only if you approve
- `rm -rf /tmp/x`  → **hard-blocked** by the control ring
- `assess example.com`  → passive web-recon → prioritized report

## How it works
`ant` is a thin client over the copilot's `/api/chat` — the model (e.g. Qwen2.5-14B), the governed `run_shell`,
the web-recon tools, and the control ring all live on the box (or a remote SSH target the copilot is pointed at).
Nothing runs locally; every decision is governed and audited server-side.

Requires a running Antaḥkaraṇa copilot (see `antahkarana-net/box/copilot/`).
