claude-intent

Claude-Intent 🎯

Automatic goal tracking for Claude Code. Set it and forget it.

Features

• Auto-detection: Goals are automatically detected from your messages
• Real-time progress: Visual progress bar after each action
• Task decomposition: Automatically breaks goals into subtasks
• Zero-friction: No commands needed, just start coding
• Terminal-native: Everything in your Claude Code terminal

Installation

From Marketplace (Recommended)

claude plugin install SabhyaC26/claude-intent

From Git Repository

git clone https://github.com/SabhyaC26/claude-intent
cd claude-intent
npm install
npm run build
claude  # Start Claude Code

# In Claude Code:
/plugin marketplace add .
/plugin install claude-intent@claude-intent
# Restart Claude Code to activate

Local Development/Testing

cd /path/to/claude-intent
claude  # Start Claude Code

# In Claude Code:
/plugin marketplace add .
/plugin install claude-intent@claude-intent
# Restart Claude Code

Usage

Just start coding!

Simply tell Claude what you want to build:

You: "Add user authentication with JWT to this app"

The plugin automatically detects your goal and starts tracking:

🎯 Auto-detected goal: Add user authentication with JWT

Subtasks:
  1. Setup & dependencies (15%)
  2. Create auth service with JWT (25%)
  3. Implement login endpoint (20%)
  4. Add auth middleware (20%)
  5. Write tests (20%)

Progress will appear after each action. Use /intent to view details.

See real-time progress

After each action Claude takes, you'll see:

🎯 Add user auth… [████████░░░░░░░░] 45% │ → Create auth service │ Score: 87

Optional commands

View detailed status

/intent

View past goals

/intent history

Clear current goal

/intent clear

Manually set a goal (only if auto-detection doesn't work)

/intent:set Implement user authentication with JWT

Configuration

Claude-Intent uses Claude Code's built-in API access - no API key needed!

Optionally edit ~/.claude-intent/config.json:

{
  "model": "claude-haiku-4.5-20250514"
}

• model: Claude model for analysis (default: claude-haiku-4.5-20250514 for fast, cost-effective tracking)

How It Works

1. Auto-Detection: When you send a message, Claude-Intent analyzes it to detect if it contains a coding goal
2. Task Decomposition: Detected goals are automatically broken down into trackable subtasks using the Claude API
3. Action Tracking: After each tool use (Read, Edit, Bash, etc.), the plugin scores how relevant the action is to your goal
4. Progress Estimation: Based on completed actions, Claude estimates progress on each subtask and shows you real-time updates
5. Goal Completion: When you reach 100%, the goal is marked complete and saved to history

Requirements

• Claude Code CLI (built-in API access used automatically)
• Node.js 18+

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

Contributing

Pull requests welcome! Please ensure your code follows the existing style and includes appropriate tests.

Troubleshooting

Plugin not loading

• Make sure you've run npm run build before installing
• Check that dist/cli.js exists

Goals not being auto-detected

• The plugin requires clear, actionable goals (not questions or casual chat)
• Try manually setting a goal with /intent:set <your goal>
• Check that Claude Code is running properly

No progress showing

• Check that a goal was detected (you should see the auto-detection message)
• Try viewing status with /intent
• Verify the plugin is properly installed and built

Roadmap

• Auto-detect goals from user messages
• Real-time progress display
• Simplified command structure
• Custom subtask editing
• Export session reports
• Integration with project management tools
• Multi-goal support
• Historical analytics and insights