graphe-cli 0.1.4

Command-line interface for the Graphe API

graphe-cli

Command-line interface for Graphe — query shared agent memory, search project context, and ingest events.

Install

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	Optional — auto-resolved via graphe whoami / GET /api/v1/me
GRAPHE_PROJECT_ID	Optional — auto-resolved
GRAPHE_ACTOR_ID	Optional — auto-resolved for ingestion

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

Examples

graphe health
graphe whoami
graphe --output json state
graphe --output json runs create --goal "VS Code CLI test"
graphe search -q "authentication middleware"
graphe runs list
graphe runs trace <run-id>
graphe runs issues <run-id>
graphe runs explain <run-id>
graphe events log --event-type agent.action --summary "Started refactor" --run-id <run-id>
graphe claims propose --file claim.json

Use --output json for machine-readable output. Full command list: COMMANDS.md. Discover live: graphe --help, graphe runs --help.

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 for cloud setup and API keys.