echograph 0.1.0

Context Engineering CLI for Claude Code

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:

# 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

# 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.

# 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.

# 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.

# 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.

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

# 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