Skip to content

CLI_README.md

Latest commit

 

History

History
97 lines (72 loc) · 2.06 KB

CLI_README.md

File metadata and controls

97 lines (72 loc) · 2.06 KB

HCR CLI - Commercial-Grade Developer Tool

Professional CLI for HCR (Hybrid Cognitive Runtime) - the state-based AI context system.

Quick Start

Install

pipx install hcr-mcp

No pipx? pip install pipx && pipx ensurepath, then restart your terminal.

First-time setup

hcr init --auto

hcr init detects missing credentials and prompts you to log in (opens browser). After auth it initializes the project, wires your IDE's MCP config, and installs git hooks — one command, nothing else required.

Manual steps (if needed)

hcr login             # Authenticate via browser (device flow)
hcr init --auto       # Initialize project + configure IDE

Commands

Setup (One-time)

hcr login             # Authenticate (opens browser, auto-saves credentials)
hcr init              # Initialize HCR in current project (prompts login if needed)
hcr doctor            # Check installation health

Daily Use

hcr status            # Quick health overview
hcr graph             # Visual dependency tree
hcr clean             # Optimize state files

Maintenance

hcr clean             # Compress facts, checkpoint, archive events
hcr reset --force     # Clear all state (careful!)

CLI vs MCP

Use CLI for:

  • Project setup and initialization
  • System diagnostics and maintenance
  • Visual output (dependency graphs)
  • File system operations (clean, reset)

Use MCP for:

  • AI IDE integration
  • Getting current task context
  • Analyzing file impact
  • Recording file edits
Feature CLI MCP
hcr init ✅ ❌
hcr status ✅ ❌
hcr graph ✅ ❌
hcr clean ✅ ❌
hcr_get_current_task ❌ ✅
hcr_analyze_impact ❌ ✅
hcr_record_file_edit ❌ ✅

Examples

# Initialize in a new project
cd my-project
hcr init

# Check health
hcr doctor

# See what's being tracked
hcr status

# View dependency tree
hcr graph

# Optimize after heavy development
hcr clean

Version

Current: 0.2.0