Metadata-Version: 2.3
Name: agent-brain-cli
Version: 1.1.0
Summary: CLI management tool for agent-brain-rag server
License: MIT
Keywords: rag,cli,documentation,semantic-search,ai-agent,brain
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

# doc-svr-ctl

Command-line interface for managing the Doc-Serve document indexing and search server.

## Installation

```bash
pip install doc-serve-cli
```

## Quick Start

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

## Development Installation

```bash
cd doc-svr-ctl
poetry install
```

## Usage

```bash
# Check server status
doc-svr-ctl status

# Search documents
doc-svr-ctl query "how to use python"

# Index documents from a folder
doc-svr-ctl index ./docs

# Reset/clear the index
doc-svr-ctl reset --yes
```

## Configuration

Set the server URL via environment variable:

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

Or use the `--url` flag:

```bash
doc-svr-ctl --url http://localhost:8000 status
```

## Commands

| Command | Description |
|---------|-------------|
| `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 `DOC_SERVE_URL` env var)
- `--json` - Output as JSON for scripting

