Metadata-Version: 2.4
Name: graphe-cli
Version: 0.1.1
Summary: Command-line interface for the Graphe API
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: graphe-sdk>=0.1.1
Requires-Dist: typer>=0.12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"

# graphe-cli

Command-line interface for [Graphe](https://graphe.dev) — query shared agent memory, search project context, and ingest events.

## Install

```bash
pip install graphe-cli
```

## Configuration

Environment variables:

| Variable | Purpose |
|----------|---------|
| `GRAPHE_API_BASE` | API URL (default `http://localhost:8000`) |
| `GRAPHE_API_KEY` | API key from the Graphe console |
| `GRAPHE_WORKSPACE_ID` | Default workspace |
| `GRAPHE_PROJECT_ID` | Default project |
| `GRAPHE_ACTOR_ID` | Default actor for ingestion |

Optional config file: `~/.config/graphe/config.toml` or `./graphe.toml`.

## Examples

```bash
graphe health
graphe --output json state
graphe search -q "authentication middleware"
graphe runs list --workspace <ws> --project <proj>
graphe runs trace <run-id>
graphe events log --event-type agent.action --summary "Started refactor"
graphe claims propose --file claim.json
```

Use `--output json` for machine-readable output.

Claim lifecycle commands (`propose`, `confirm`, `invalidate`, `supersede`) are available in the CLI. The MCP server focuses on read tools and safe ingestion writes.

## Documentation

See [connecting clients](https://github.com/ShauryaVM/KG-Idea/blob/main/docs/connecting-clients.md) for cloud setup and API keys.
