@braingrid/cli 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -5,6 +5,73 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.4] - 2025-11-10
+
+### Added
+
+- **BrainGrid context in Claude Code status line** (#36)
+  - Two-line status display showing project/requirement/task progress
+  - Auto-detects from `.braingrid/project.json` and git branch names
+  - Color-coded output: cyan for project, green for requirement, yellow for tasks
+  - Displays current task completion (e.g., `PROJ-130 > REQ-128 [2/5]`)
+  - Always shows workspace path, model name, and token usage
+  - Installed automatically with `braingrid setup claude-code`
+
+- **Setup commands for Claude Code and Cursor integrations** (#35)
+  - New `braingrid setup claude-code` command installs slash commands and skills
+  - New `braingrid setup cursor` command installs Cursor rules and commands
+  - Fetches integration files from BrainGridAI/braingrid repository
+  - Injects content into CLAUDE.md or AGENTS.md with markers
+  - Interactive prompts for file conflicts with overwrite/skip/all/quit options
+  - Dry-run mode with `--dry-run` flag
+  - Force mode with `--force` flag to skip all prompts
+
+- **Cursor IDE integration** (#34)
+  - Added AGENTS.md standard for Cursor AI agent configuration
+  - Supports auto-detection of project and requirement context
+  - Works with agent mode for autonomous task execution
+
+- **Claude Code sync automation** (#33)
+  - New `pnpm docs:sync-claude` command syncs skills and slash commands
+  - Automatically updates BrainGridAI/braingrid repository
+  - Keeps Claude Code integration files in sync across repos
+
+### Fixed
+
+- **Status line script path resolution** (code review fixes)
+  - Fixed critical bug using `import.meta.url` instead of `process.cwd()`
+  - Script now loads from package location, not user's directory
+  - Prevents "file not found" errors during setup
+
+- **Shell script error handling**
+  - Added `set -o pipefail` to status line script
+  - Properly detects braingrid command failures in pipelines
+  - More robust JSON parsing with better error detection
+
+- **Token display formatting**
+  - Fixed bug showing incorrect token counts (e.g., "24000k/200000k")
+  - Now correctly displays as "24k/200k tokens"
+
+## [0.2.3] - 2025-01-10
+
+### Added
+
+- New `task summary` subcommand for quick table overview without content
+  - Use `braingrid task summary -r REQ-X` for compact task list
+  - Complements full detail view with lightweight summary option
+
+### Changed
+
+- Simplified CLI output format with markdown as default
+  - `requirement breakdown` now defaults to markdown format (was table)
+  - `task list` now defaults to markdown format with full content (was table)
+  - Removed `--verbose` flag - full content always shown by default for AI-ready output
+  - Use `--format table` or new `task summary` command for compact view
+- Updated `/breakdown` slash command documentation
+  - Removed all `--verbose` flag references
+  - Updated examples to use new default markdown format
+  - Added references to `task summary` for quick overviews
+
 ## [0.2.2] - 2025-11-10
 
 ### Added

package/README.md

@@ -37,6 +37,80 @@ npm install -g @braingrid/cli
 
 ---
 
+## AI Coding Tool Integration
+
+BrainGrid integrates natively with AI coding tools like **Cursor IDE** and **Claude Code** through the [AGENTS.md standard](https://agents.md/), providing seamless access to spec-driven development workflows directly in your editor.
+
+### What is AGENTS.md?
+
+[AGENTS.md](https://agents.md/) is an open standard that allows AI coding assistants to automatically load project-specific guidance and commands. BrainGrid uses this standard to provide consistent CLI guidance across multiple tools:
+
+- ✅ **Cursor IDE** - Automatic loading via AGENTS.md + slash commands
+- ✅ **Claude Code** - Automatic loading via AGENTS.md or .claude/CLAUDE.md
+- ✅ **GitHub Copilot** - Context from AGENTS.md
+- ✅ **Growing ecosystem** of AGENTS.md-compatible tools
+
+### Setup for Cursor IDE
+
+**Prerequisites:**
+
+- Cursor IDE installed ([download here](https://cursor.sh/))
+- BrainGrid CLI installed and authenticated
+
+**How it works:**
+
+1. **AGENTS.md** at your repository root is automatically loaded by Cursor
+2. **.cursor/rules/braingrid.mdc** provides Cursor-specific enhancements (always-on rules)
+3. **Slash commands** available via `/` in Cursor's Agent input
+
+**Available Commands:**
+
+Type `/` in Cursor's Agent input to access:
+
+- `/specify` - Create AI-refined requirements from natural language
+- `/breakdown` - Break requirements into implementation tasks
+- `/save-requirement` - Save requirement content to BrainGrid
+- `/build` - Generate complete implementation plan
+
+**Quick Start Example:**
+
+```bash
+# In Cursor IDE Agent input
+/specify "Add user authentication with OAuth2"
+# → Creates REQ-123
+
+/breakdown REQ-123
+# → Generates 5-10 implementation tasks
+
+/build REQ-123
+# → Shows complete requirement with all task prompts
+```
+
+### Setup for Claude Code
+
+BrainGrid's AGENTS.md file also works with Claude Code. You can either:
+
+1. **Use AGENTS.md directly** (Claude Code automatically reads it)
+2. **Symlink for compatibility**: `ln -s AGENTS.md .claude/CLAUDE.md`
+
+Claude Code also provides its own slash commands in `.claude/commands/`.
+
+### Cross-IDE Compatibility
+
+The AGENTS.md standard ensures your BrainGrid setup works across tools:
+
+- **AGENTS.md** provides CLI guidance for all compatible tools
+- **Tool-specific directories** (.cursor/, .claude/) add enhanced features
+- **Single source of truth** for BrainGrid workflows
+
+**Learn more:**
+
+- [AGENTS.md standard](https://agents.md/)
+- [BrainGrid documentation](https://www.braingrid.ai)
+- Full CLI command reference in [AGENTS.md](./AGENTS.md)
+
+---
+
 ## QuickStart: One-Minute Flow
 
 ```bash
@@ -87,6 +161,69 @@ The `init` command creates a `.braingrid/project.json` file in the `.braingrid/`
 
 > **Note:** The init command always asks for confirmation before initializing unless you use the `--force` flag.
 
+### Setup Commands
+
+Install BrainGrid integration files for AI coding tools. These commands fetch integration files from the [BrainGrid repository](https://github.com/BrainGridAI/braingrid) and install them in your project.
+
+**Prerequisites:**
+
+- **GitHub CLI** must be installed and authenticated
+  - macOS: `brew install gh`
+  - Windows: `winget install GitHub.CLI`
+  - Linux: See [GitHub CLI installation](https://cli.github.com/manual/installation)
+  - After installing: `gh auth login`
+
+**Commands:**
+
+```bash
+# Install Claude Code integration
+braingrid setup claude-code
+
+# Install Cursor integration
+braingrid setup cursor
+
+# Skip prompts and overwrite all existing files
+braingrid setup claude-code --force
+
+# Preview changes without making modifications
+braingrid setup cursor --dry-run
+```
+
+**What gets installed:**
+
+- **Claude Code integration:**
+  - Commands in `.claude/commands/` (specify, breakdown, build, save-requirement)
+  - Skills in `.claude/skills/braingrid-cli/`
+  - Content injected into `CLAUDE.md` (or creates it if it doesn't exist)
+
+- **Cursor integration:**
+  - Commands in `.cursor/commands/` (specify, breakdown, build, save-requirement)
+  - Rules in `.cursor/rules/`
+  - Content injected into `AGENTS.md` (or creates it if it doesn't exist)
+
+**Options:**
+
+- `--force` - Skip prompts and overwrite all existing files without asking
+- `--dry-run` - Show what would be done without making any changes
+
+**File Conflicts:**
+
+When files already exist, you'll be prompted to choose:
+
+- `[O]verwrite` - Replace this file
+- `[S]kip` - Keep existing file
+- `[A]ll` - Overwrite all remaining files
+- `[Q]uit` - Cancel installation
+
+**Marker-based Updates:**
+
+Running setup again will update the BrainGrid sections in `CLAUDE.md` or `AGENTS.md` without duplicating content. The CLI uses HTML comment markers to identify and replace existing BrainGrid content.
+
+**Learn more:**
+
+- [Claude Code integration guide](https://braingrid.ai/docs/integrations/claude-code)
+- [Cursor integration guide](https://braingrid.ai/docs/integrations/cursor)
+
 ### Project Commands
 
 ```bash