Metadata-Version: 2.4
Name: ctxos-cli
Version: 0.1.0
Summary: CLI for Context OS — Memory, Search, Crawl, Knowledge
Project-URL: Homepage, https://github.com/AmanSagar0607/Context-OS
Project-URL: Repository, https://github.com/AmanSagar0607/Context-OS
Author-email: Aman Sagar <aman@amansagar.in>
License-Expression: MIT
Keywords: ai,cli,context,crawl,knowledge-graph,mcp,memory,search
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: click>=8.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# Context OS — CLI

Command-line interface for Context OS operations.

## Installation

```bash
pip install context-cli
```

Or install from source:

```bash
git clone https://github.com/AmanSagar0607/Context-OS.git
cd Context-OS/cli
pip install -e .
```

## Configuration

Set environment variables:

```bash
export CONTEXT_API_URL="http://localhost:8000"  # API server
export CONTEXT_API_KEY="your-api-key"           # API key (optional)
```

## Commands

### Memory

```bash
# Add a memory
context memory add -c "User prefers dark mode" --type semantic --importance high --tags "ui,preferences"

# Get a memory
context memory get <memory-id>

# Search memories
context memory search "dark mode" --limit 10

# List memories
context memory list --type semantic --limit 20

# Delete a memory
context memory delete <memory-id>
```

### Search

```bash
# Web search
context search web "AI news 2025" --limit 5

# Internal hybrid search
context search internal "user preferences" --limit 10
```

### Crawl

```bash
# Scrape a URL
context crawl scrape https://example.com

# Map a website
context crawl map https://example.com --limit 50
```

### Knowledge

```bash
# Create an entity
context knowledge create-entity --name "GPT-4" --type model --description "Large language model"

# Search entities
context knowledge search "language models" --limit 10
```

### Health

```bash
# Check API health
context health
```

## License

MIT License