Metadata-Version: 2.3
Name: agent-brain-cli
Version: 1.2.0
Summary: Agent Brain CLI - Command-line interface for managing AI agent memory and knowledge retrieval
License: MIT
Keywords: agent-brain,rag,cli,ai-memory,llm-memory,semantic-search,ai-agent,claude-code,agent-memory
Author: Spillwave Solutions
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click (>=8.1.0,<9.0.0)
Requires-Dist: httpx (>=0.28.0,<0.29.0)
Requires-Dist: rich (>=13.9.0,<14.0.0)
Project-URL: Homepage, https://github.com/SpillwaveSolutions/doc-serve
Project-URL: Repository, https://github.com/SpillwaveSolutions/doc-serve
Description-Content-Type: text/markdown

# Agent Brain CLI

Command-line interface for managing AI agent memory and knowledge retrieval with the Agent Brain RAG server.

## Installation

```bash
pip install agent-brain-cli
```

## Quick Start

```bash
agent-brain init          # Initialize project
agent-brain start         # Start server
agent-brain index ./docs  # Index documents
agent-brain query "search term"
```

> **Note**: The legacy command `doc-svr-ctl` is still available but deprecated. Please use `agent-brain` for new installations.

## Development Installation

```bash
cd agent-brain-cli
poetry install
```

## Usage

```bash
# Check server status
agent-brain status

# Search documents
agent-brain query "how to use python"

# Index documents from a folder
agent-brain index ./docs

# Reset/clear the index
agent-brain reset --yes
```

## Configuration

Set the server URL via environment variable:

```bash
export AGENT_BRAIN_URL=http://localhost:8000
```

Or use the `--url` flag:

```bash
agent-brain --url http://localhost:8000 status
```

> **Note**: The legacy environment variable `DOC_SERVE_URL` is still supported for backwards compatibility.

## Commands

| Command | Description |
|---------|-------------|
| `init` | Initialize project for Agent Brain |
| `start` | Start the Agent Brain server |
| `stop` | Stop the running server |
| `list` | List all running Agent Brain instances |
| `status` | Check server health and indexing status |
| `query` | Search indexed documents |
| `index` | Start indexing documents from a folder |
| `reset` | Clear all indexed documents |

## Options

All commands support:
- `--url` - Server URL (or `AGENT_BRAIN_URL` / `DOC_SERVE_URL` env var)
- `--json` - Output as JSON for scripting

