Claude Code Integration

Transform your PROJECT.md into intelligent, automatic task tracking

🆕 NEW in v0.4.0: Simple Start/Done Workflow!

Stop manually updating checkboxes in PROJECT.md files. Our Claude Code hooks automatically track your development progress, map code changes to tasks, and keep your team synchronized in real-time. Zero manual work required!

🔄 Automatic Tracking

Tasks update automatically when you modify files with Claude Code. PaymentController.php → payment tasks become "in progress".

✅ Commit Recognition

Write git commit -m "closes #123" and Task #123 automatically gets marked as done. Smart completion detection.

📝 Smart CLAUDE.md

Auto-generated project context that's always up-to-date. Claude Code knows exactly what you're working on and what's next.

🚀 5-Minute Setup

Get automatic task tracking running in 5 minutes. No more manual PROJECT.md updates!

Install the CLI

✅ Available Now - NPM Installation

npm install -g @200notes/claude-code

Configure Authentication

200notes auth login

Enter your API credentials from the 200notes dashboard

Initialize Your Project

cd your-project && 200notes init "My Project"

Create Tasks from PROJECT.md

200notes task create "Stripe webhook implementation" --tags stripe,backend

200notes task create "Payment validation" --tags payment,frontend

Replace your manual checkboxes with trackable tasks

🆕 Set Up Automatic Hooks

cp -r "$(npm root -g)/@200notes/claude-code/hooks" ./

cp -r "$(npm root -g)/@200notes/claude-code/.claude" ./

chmod +x hooks/*.sh

Copy hooks and Claude Code settings to enable automatic tracking

✓

Ready! Now start your workflow

Setup complete! Use the simple 3-step workflow below to manage tasks with Claude Code.

⚡ Simple 3-Step Workflow

Manage your tasks effortlessly with Claude Code integration. No complex configuration needed!

🚀 Start Tasks

200notes start

Automatically fetches your next priority tasks and sets them to "in progress"

• Fetches pending tasks

• Sets 3 tasks to "in_progress"

• Updates CLAUDE.md

💻 Work with Claude

claude "Let's work on the tasks"

Claude Code automatically tracks your progress as you modify files

• CLAUDE.md stays updated

• File changes tracked

• Auto commit detection

✅ Mark Done

200notes done

Marks all active session tasks as completed

• Sets tasks to "done"

• Ends current session

• Updates team status

💬 How to Communicate with Claude Code

Examples of how to talk to Claude Code for the best workflow experience:

🚀 Starting Your Work Session

You say:

"Let's work on the next tasks"

"I want to start coding today's priorities"

"Show me what needs to be done and let's begin"

Claude does:

1. Runs 200notes start

2. Shows you the selected tasks

3. Reads CLAUDE.md for context

4. Begins working on the code

💻 During Development

You say:

"Fix the payment validation bug"

"Add tests for the new API endpoint"

"Update the documentation"

Claude does:

• Modifies relevant files

• Hooks automatically update CLAUDE.md

• Progress is tracked in 200notes

• Team sees real-time updates

✅ Finishing Your Session

You say:

"We're done with these tasks"

"Mark the current work as completed"

"Let's commit and close these tasks"

Claude does:

1. Runs 200notes done

2. Sets tasks to "completed"

3. Updates final CLAUDE.md

4. Can commit with "closes #123"

💡 Pro Tips

Smart Completions:

• Say "git commit with closes #123" to auto-complete specific tasks

• Claude recognizes completion patterns in commits

• Manual completion with 200notes done --task 123

Filtering Tasks:

• 200notes start --priority high

• 200notes start --tag frontend,api

• 200notes start --limit 5

🆕 New in v0.4.0 - Simple Start/Done Workflow

🔄 Claude Code Hooks - Now Fully Compatible

v0.4.0 introduces a simple, intuitive workflow: start tasks, work with Claude, mark as done. Perfect for focused development sessions.

What Happens Automatically:

✓ Simple start/done workflow
✓ Commit "closes #123" → Task #123 marked done
✓ CLAUDE.md auto-updated with context
✓ Session-based task management

New Commands:

200notes start → Begin working on next tasks

200notes done → Complete current session

200notes done --task 123 → Complete specific task

200notes start --priority high → Filter by priority

⚡ Enhanced CLI Commands

File-Based Task Updates:

200notes task update dummy --file-keywords "auth,payment" --status in_progress

Update all tasks containing "auth" or "payment" keywords

Auto CLAUDE.md Updates:

200notes sync --update-claude-md

Regenerate project context with current task status

🧠 How Automatic Tracking Works

Live Workflow Example

You start Claude Code session

CLAUDE.md automatically loaded with current tasks and priorities

Claude Code modifies: `src/controllers/PaymentController.php`

Hook detects keywords: "payment", "controller", "stripe"

Tasks auto-updated:

✓ "Stripe webhook implementation" → in_progress
✓ "Payment validation logic" → in_progress
• "User authentication" → unchanged

You commit your work:

git commit -m "closes #123: Complete Stripe webhook handler"

Task #123 automatically marked as "done"

CLAUDE.md refreshed, team notified

Project context updated, progress visible to everyone

📝 Auto-Generated CLAUDE.md Example

# E-commerce Platform v2.1

## 📊 Project Status (Updated: 2024-07-12 20:45:32)
- **Progress**: 75% complete (6/8 tasks)
- **Sprint**: Week 3 of 4
- **Team**: Alice (Backend), Bob (Frontend), Charlie (DevOps)

## 🚧 Currently Active Tasks

### In Progress
- 🔴 **Stripe webhook implementation** (#123) 
  - Assigned: Alice
  - Files: `PaymentController.php`, `WebhookHandler.php`
  - Last updated: 2 minutes ago

- 🟡 **Checkout UI improvements** (#124)
  - Assigned: Bob  
  - Files: `CheckoutPage.jsx`, `PaymentForm.jsx`
  - Last updated: 15 minutes ago

## ⏳ Next Priority Tasks
- 🔴 **Error handling for failed payments** (#125) - Unassigned
- 🟡 **PDF receipt generation** (#126) - Charlie

## ✅ Recently Completed
- ✓ User authentication system (#121) - Completed 1 hour ago
- ✓ Product catalog API (#122) - Completed yesterday

## 🎯 Suggested Next Steps
1. Complete Stripe webhook testing (Priority: High)
2. Review error handling requirements with team
3. Prepare payment flow documentation

---
*Auto-generated by 200notes • Last sync: 30 seconds ago*

💻 Complete CLI Reference

Project Setup

200notes auth login Configure API credentials

200notes init "Project Name" Initialize project with automatic tracking

200notes status Show current tasks and progress

Task Management

200notes task create "Task title" --tags auth,backend Create task with tags for smart mapping

200notes task start <task-id> Manually start working on task

200notes task done <task-id> Mark task as completed

🆕 Advanced Features

200notes task update dummy --file-keywords "auth,payment" Update tasks by file keywords

200notes sync --update-claude-md Refresh CLAUDE.md with current context

200notes task update <id> --assignee "user@team.com" Assign tasks to team members

🔧 Claude Code Hook Setup

Enable automatic task tracking by configuring Claude Code hooks for your project.

Complete Hook Installation

# 1. Copy hooks and configuration to your project
cp -r "$(npm root -g)/@200notes/claude-code/hooks" ./
cp "$(npm root -g)/@200notes/claude-code/.claude-code.json" ./

# 2. Make hook scripts executable  
chmod +x hooks/*.sh

# 3. Verify files are in place
ls -la hooks/ .claude-code.json

How It Works

Claude Code automatically detects and loads the .claude-code.json configuration file in your project root:

File: .claude-code.json (in your project root)

{
  "hooks": {
    "PostToolUse": [
      {
        "name": "200notes-task-tracker",
        "description": "Automatically update 200notes tasks based on file changes",
        "script": "./hooks/post_tool_use.sh",
        "enabled": true,
        "config": {
          "debug": false,
          "exclude_patterns": ["node_modules/**", "dist/**", ".git/**"],
          "supported_tools": ["Edit", "Write", "MultiEdit", "Bash"]
        }
      }
    ]
  }
}

✅ Project-specific: Each project can have its own hook configuration

✅ Automatic: Claude Code loads this file automatically when working in the project

✅ No global changes: No need to modify global Claude Code settings

Verification & Testing

Test that automatic tracking is working:

1. Create a test task:

200notes task create "Test automatic tracking" --tags test,hook

2. Test hook manually (optional):

TOOL_TYPE="Edit" FILE_PATH="src/test.js" DEBUG=true ./hooks/post_tool_use.sh

Should show: "Starting post-tool-use hook" and track file changes

3. Use Claude Code to edit a file:

Edit any file with "test" in the name - the task should automatically move to "in_progress"

4. Check the result:

200notes status

Should show the test task as "in_progress"

🎯 Pro Tips

💡 Add .claude-code.json to your git repository so team members get hooks automatically
💡 Set "debug": true to see detailed hook activity in terminal
💡 Customize exclude_patterns to skip irrelevant file changes
💡 Use "enabled": false to temporarily disable automatic tracking

🎯 Best Practices

Smart Task Creation

✓ Use descriptive titles: "Stripe webhook implementation" vs "Fix payment"
✓ Add relevant tags: --tags stripe,backend,webhook
✓ Set proper priorities for automatic task sorting
✓ Break large features into trackable sub-tasks

File Organization

✓ Use meaningful file names: PaymentController.php
✓ Group related files: src/payments/, src/auth/
✓ Include domain keywords in paths for better mapping

Team Workflow

✓ Assign tasks before development starts
✓ Use descriptive commit messages for auto-completion
✓ Review CLAUDE.md at session start for context
✓ Sync regularly: 200notes sync

Commit Patterns

✓ closes #123 - Mark task as done
✓ fixes #456 - Complete bugfix task
✓ resolves #789 - Finish feature task

📈 Before vs After

❌ Before: Manual PROJECT.md

❌ Manual checkbox updates in PROJECT.md
❌ Forgotten progress updates
❌ No team visibility into progress
❌ Outdated project context for Claude
❌ Time wasted on project management

✅ After: Automatic 200notes

✅ Fully automatic task tracking
✅ Real-time progress updates
✅ Complete team synchronization
✅ Always-current CLAUDE.md context
✅ Zero manual project management

🚀 Ready to Automate Your Project Management?

Join developers who've eliminated manual PROJECT.md updates forever. Get intelligent, automatic task tracking in 5 minutes.

Get Your API Keys Free View on GitHub

🎉 v0.2.0 Available Now: npm install -g @200notes/claude-code

Claude Code Integration

🆕 NEW in v0.4.0: Simple Start/Done Workflow!

🔄 Automatic Tracking

✅ Commit Recognition

📝 Smart CLAUDE.md

🚀 5-Minute Setup

Install the CLI

Configure Authentication

Initialize Your Project

Create Tasks from PROJECT.md

🆕 Set Up Automatic Hooks

Ready! Now start your workflow

⚡ Simple 3-Step Workflow

🚀 Start Tasks

💻 Work with Claude

✅ Mark Done

💬 How to Communicate with Claude Code

🚀 Starting Your Work Session

You say:

Claude does:

💻 During Development

You say:

Claude does:

✅ Finishing Your Session

You say:

Claude does:

💡 Pro Tips

Smart Completions:

Filtering Tasks:

🆕 New in v0.4.0 - Simple Start/Done Workflow

🔄 Claude Code Hooks - Now Fully Compatible

What Happens Automatically:

New Commands:

⚡ Enhanced CLI Commands

File-Based Task Updates:

Auto CLAUDE.md Updates:

🧠 How Automatic Tracking Works

Live Workflow Example

You start Claude Code session

Claude Code modifies: src/controllers/PaymentController.php

Tasks auto-updated:

You commit your work:

CLAUDE.md refreshed, team notified

📝 Auto-Generated CLAUDE.md Example

💻 Complete CLI Reference

Project Setup

Task Management

🆕 Advanced Features

🔧 Claude Code Hook Setup

Complete Hook Installation

How It Works

Verification & Testing

1. Create a test task:

2. Test hook manually (optional):

3. Use Claude Code to edit a file:

4. Check the result:

🎯 Pro Tips

🎯 Best Practices

Smart Task Creation

File Organization

Team Workflow

Commit Patterns

📈 Before vs After

❌ Before: Manual PROJECT.md

✅ After: Automatic 200notes

🚀 Ready to Automate Your Project Management?

Claude Code modifies: `src/controllers/PaymentController.php`