agent-brain-cli 2.0.0__tar.gz

agent_brain_cli-2.0.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.3
+Name: agent-brain-cli
+Version: 2.0.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: Documentation, https://github.com/SpillwaveSolutions/agent-brain/wiki
+Project-URL: Homepage, https://github.com/SpillwaveSolutions/agent-brain
+Project-URL: Repository, https://github.com/SpillwaveSolutions/agent-brain
+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.
+
+**Agent Brain** (formerly doc-serve) is an intelligent document indexing and semantic search system designed to give AI agents long-term memory. This CLI provides a convenient way to manage your Agent Brain server and knowledge base.
+
+[![PyPI version](https://badge.fury.io/py/agent-brain-cli.svg)](https://pypi.org/project/agent-brain-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Why Agent Brain?
+
+AI agents need persistent memory to be truly useful. Agent Brain provides the retrieval infrastructure that enables context-aware, knowledge-grounded AI interactions.
+
+### Search Capabilities
+
+| Search Type | Description | Best For |
+|-------------|-------------|----------|
+| **Semantic Search** | Natural language queries using OpenAI embeddings | Conceptual questions, related content |
+| **Keyword Search (BM25)** | Traditional keyword matching with TF-IDF ranking | Exact matches, technical terms |
+| **Hybrid Search** | Combines vector + BM25 approaches | General-purpose queries |
+| **GraphRAG** | Knowledge graph retrieval | Understanding relationships |
+
+## 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
+
+### Server Management
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize project for Agent Brain (creates `.claude/doc-serve/`) |
+| `start` | Start the Agent Brain server for current project |
+| `stop` | Stop the running server |
+| `list` | List all running Agent Brain instances |
+| `status` | Check server health and indexing status |
+
+### Data Management
+
+| Command | Description |
+|---------|-------------|
+| `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
+
+## Example Workflow
+
+```bash
+# 1. Initialize a new project
+cd my-project
+agent-brain init
+
+# 2. Start the server
+agent-brain start
+
+# 3. Index your documentation
+agent-brain index ./docs ./src
+
+# 4. Query your knowledge base
+agent-brain query "How does authentication work?"
+
+# 5. Stop when done
+agent-brain stop
+```
+
+## Documentation
+
+- [User Guide](https://github.com/SpillwaveSolutions/agent-brain/wiki/User-Guide) - Getting started and usage
+- [Developer Guide](https://github.com/SpillwaveSolutions/agent-brain/wiki/Developer-Guide) - Contributing and development
+- [API Reference](https://github.com/SpillwaveSolutions/agent-brain/wiki/API-Reference) - Full API documentation
+
+## Release Information
+
+- **Current Version**: See [pyproject.toml](./pyproject.toml)
+- **Release Notes**: [GitHub Releases](https://github.com/SpillwaveSolutions/agent-brain/releases)
+- **Changelog**: [Latest Release](https://github.com/SpillwaveSolutions/agent-brain/releases/latest)
+
+## Related Packages
+
+- [agent-brain-rag](https://pypi.org/project/agent-brain-rag/) - The RAG server that powers Agent Brain
+
+## License
+
+MIT
+

agent_brain_cli-2.0.0/README.md

@@ -0,0 +1,144 @@
+# Agent Brain CLI
+
+> Command-line interface for managing AI agent memory and knowledge retrieval with the **Agent Brain** RAG server.
+
+**Agent Brain** (formerly doc-serve) is an intelligent document indexing and semantic search system designed to give AI agents long-term memory. This CLI provides a convenient way to manage your Agent Brain server and knowledge base.
+
+[![PyPI version](https://badge.fury.io/py/agent-brain-cli.svg)](https://pypi.org/project/agent-brain-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Why Agent Brain?
+
+AI agents need persistent memory to be truly useful. Agent Brain provides the retrieval infrastructure that enables context-aware, knowledge-grounded AI interactions.
+
+### Search Capabilities
+
+| Search Type | Description | Best For |
+|-------------|-------------|----------|
+| **Semantic Search** | Natural language queries using OpenAI embeddings | Conceptual questions, related content |
+| **Keyword Search (BM25)** | Traditional keyword matching with TF-IDF ranking | Exact matches, technical terms |
+| **Hybrid Search** | Combines vector + BM25 approaches | General-purpose queries |
+| **GraphRAG** | Knowledge graph retrieval | Understanding relationships |
+
+## 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
+
+### Server Management
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize project for Agent Brain (creates `.claude/doc-serve/`) |
+| `start` | Start the Agent Brain server for current project |
+| `stop` | Stop the running server |
+| `list` | List all running Agent Brain instances |
+| `status` | Check server health and indexing status |
+
+### Data Management
+
+| Command | Description |
+|---------|-------------|
+| `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
+
+## Example Workflow
+
+```bash
+# 1. Initialize a new project
+cd my-project
+agent-brain init
+
+# 2. Start the server
+agent-brain start
+
+# 3. Index your documentation
+agent-brain index ./docs ./src
+
+# 4. Query your knowledge base
+agent-brain query "How does authentication work?"
+
+# 5. Stop when done
+agent-brain stop
+```
+
+## Documentation
+
+- [User Guide](https://github.com/SpillwaveSolutions/agent-brain/wiki/User-Guide) - Getting started and usage
+- [Developer Guide](https://github.com/SpillwaveSolutions/agent-brain/wiki/Developer-Guide) - Contributing and development
+- [API Reference](https://github.com/SpillwaveSolutions/agent-brain/wiki/API-Reference) - Full API documentation
+
+## Release Information
+
+- **Current Version**: See [pyproject.toml](./pyproject.toml)
+- **Release Notes**: [GitHub Releases](https://github.com/SpillwaveSolutions/agent-brain/releases)
+- **Changelog**: [Latest Release](https://github.com/SpillwaveSolutions/agent-brain/releases/latest)
+
+## Related Packages
+
+- [agent-brain-rag](https://pypi.org/project/agent-brain-rag/) - The RAG server that powers Agent Brain
+
+## License
+
+MIT

agent_brain_cli-2.0.0/agent_brain_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Doc-Serve CLI - Command-line interface for managing Doc-Serve server."""
+
+__version__ = "2.0.0"

agent_brain_cli-2.0.0/agent_brain_cli/cli.py

@@ -0,0 +1,102 @@
+"""Main CLI entry point for agent-brain CLI.
+
+This module provides the command-line interface for managing and querying
+the Agent Brain RAG server. The primary entry point is `agent-brain`,
+with `doc-svr-ctl` provided for backward compatibility.
+"""
+
+import sys
+import warnings
+
+import click
+
+from . import __version__
+from .commands import (
+    index_command,
+    init_command,
+    list_command,
+    query_command,
+    reset_command,
+    start_command,
+    status_command,
+    stop_command,
+)
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="agent-brain")
+def cli() -> None:
+    """Agent Brain CLI - Manage and query the Agent Brain RAG server.
+
+    A command-line interface for interacting with the Agent Brain document
+    indexing and semantic search API.
+
+    \b
+    Project Commands:
+      init     Initialize a new agent-brain project
+      start    Start the server for this project
+      stop     Stop the server for this project
+      list     List all running agent-brain instances
+
+    \b
+    Server Commands:
+      status   Check server status
+      query    Search documents
+      index    Index documents from a folder
+      reset    Clear all indexed documents
+
+    \b
+    Examples:
+      agent-brain init                      # Initialize project
+      agent-brain start                     # Start server
+      agent-brain status                    # Check server status
+      agent-brain query "how to use python" # Search documents
+      agent-brain index ./docs              # Index documents
+      agent-brain stop                      # Stop server
+
+    \b
+    Environment Variables:
+      DOC_SERVE_URL  Server URL (default: http://127.0.0.1:8000)
+    """
+    pass
+
+
+def cli_deprecated() -> None:
+    """Deprecated entry point for doc-svr-ctl command.
+
+    Shows a deprecation warning and then runs the main CLI.
+    """
+    warnings.warn(
+        "\n"
+        "WARNING: 'doc-svr-ctl' is deprecated and will be removed in v2.0.\n"
+        "Please use 'agent-brain' instead.\n"
+        "\n"
+        "Migration guide: docs/MIGRATION.md\n"
+        "Online: https://github.com/SpillwaveSolutions/agent-brain/blob/main/docs/MIGRATION.md\n",
+        DeprecationWarning,
+        stacklevel=1,
+    )
+    # Print to stderr for visibility since warnings may be filtered
+    print(
+        "\033[93mWARNING: 'doc-svr-ctl' is deprecated. "
+        "Use 'agent-brain' instead. See docs/MIGRATION.md\033[0m",
+        file=sys.stderr,
+    )
+    cli()
+
+
+# Register project management commands
+cli.add_command(init_command, name="init")
+cli.add_command(start_command, name="start")
+cli.add_command(stop_command, name="stop")
+cli.add_command(list_command, name="list")
+
+# Register server interaction commands
+cli.add_command(status_command, name="status")
+cli.add_command(query_command, name="query")
+cli.add_command(index_command, name="index")
+cli.add_command(reset_command, name="reset")
+
+
+if __name__ == "__main__":
+    cli()

agent_brain_cli-2.0.0/agent_brain_cli/client/__init__.py

@@ -0,0 +1,5 @@
+"""HTTP client for communicating with Doc-Serve server."""
+
+from .api_client import ConnectionError, DocServeClient, DocServeError, ServerError
+
+__all__ = ["DocServeClient", "DocServeError", "ConnectionError", "ServerError"]