Metadata-Version: 2.4
Name: echograph
Version: 0.1.0
Summary: Context Engineering CLI for Claude Code
Project-URL: Homepage, https://github.com/echograph/echograph
Project-URL: Documentation, https://echograph.dev/docs
Project-URL: Repository, https://github.com/echograph/echograph
Author: EchoGraph Team
License: MIT
Keywords: ai,claude,cli,context-engineering,developer-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: jinja2>=3.1.0
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.0
Description-Content-Type: text/markdown

# EchoGraph CLI

Context Engineering CLI for Claude Code - scaffold, validate, and maintain your AI-assisted development workflow.

## Installation

### From Source (Current)

EchoGraph is not yet published to PyPI. Install from source:

```bash
# Clone and install
git clone https://github.com/echograph/echograph
cd echograph
uv sync --all-packages

# Verify it works
uv run echograph --help
```

> **Note:** `--all-packages` is required because this is a monorepo.

### From PyPI (Coming Soon)

Once published, installation will be: `pip install echograph`

## Quick Start

```bash
# Navigate to your project
cd /path/to/your-project

# Initialize Context Engineering
uv run echograph init

# Check your setup
uv run echograph doctor

# Validate context files
uv run echograph validate
```

## Commands

### `echograph init`

Scaffold a `.claude/` directory with Context Engineering templates.

```bash
# Interactive mode (asks questions)
uv run echograph init

# Minimal setup (core files only)
uv run echograph init --minimal

# Full setup (all templates and commands)
uv run echograph init --full

# Overwrite existing files
uv run echograph init --force

# Initialize a specific directory
uv run echograph init /path/to/project
```

**Created files (minimal):**
- `.claude/CLAUDE.md` - Project conventions
- `.claude/PLANNING.md` - Architecture and goals
- `.claude/TASK.md` - Task tracking

**Additional files (full):**
- `.claude/commands/` - Slash commands
- `.claude/tasks/` - Feature task templates
- `PRPs/` - Product Requirement Prompts structure

### `echograph update`

Update templates while preserving your customizations using three-way merge.

```bash
# Update templates
uv run echograph update

# Preview changes without modifying files
uv run echograph update --dry-run
```

**How it works:**
1. Compares your current files with the original template version
2. Merges in new template changes
3. Preserves your customizations
4. Marks conflicts for manual resolution (if any)

### `echograph validate`

Check context files for completeness and valid references.

```bash
# Validate current directory
uv run echograph validate

# Validate specific directory
uv run echograph validate /path/to/project

# Treat warnings as errors
uv run echograph validate --strict
```

**Checks performed:**
- Required files exist (CLAUDE.md, PLANNING.md, TASK.md)
- `@` imports reference existing files
- CLAUDE.md has Project Context section
- TASK.md has required sections (In Progress, Pending, Completed)

### `echograph doctor`

Diagnose your Claude Code setup.

```bash
uv run echograph doctor
```

**Checks performed:**
- Claude Code CLI is installed (`claude` command available)
- `.claude/` directory structure is correct
- MCP configuration is valid (if present)
- Project is a git repository
- Template version is current

## Configuration

The CLI auto-detects project configuration:

- **Project name**: From git remote or folder name
- **Tech stack**: From pyproject.toml, package.json, Cargo.toml, etc.
- **Test framework**: From pytest.ini, jest.config.js, etc.

Templates are customized based on detected configuration.

## Coming Soon

These commands show a "coming soon" message:

- `echograph search` - Semantic code search
- `echograph sync` - Sync external sources (GitHub, Azure DevOps)
- `echograph decision` - Track architectural decisions

## Development

```bash
# Clone the repository
git clone https://github.com/echograph/echograph
cd echograph

# Install dependencies
uv sync --all-packages

# Run tests
uv run pytest --cov

# Run linters
uv run ruff check packages/cli/
uv run mypy packages/cli/src/
```

## License

MIT
