Claude Code Task Manager

Transform every AI conversation into a traceable, actionable task.

Overview

Claude Code Task Manager bridges the gap between AI-assisted development and project management. Every time you start a new Claude Code session, this extension automatically prompts you to create a corresponding task in ClickUp.

No more lost ideas. No more forgotten conversations. Every AI interaction becomes a tracked deliverable.

Features

Automatic Session Detection

When you open a project, the extension detects new Claude Code sessions and prompts you to create a task.

ClickUp Integration

• Direct API integration with ClickUp
• Tasks are created with full session metadata
• Automatic tagging for easy filtering

Session Traceability

Each task includes:

• Session ID - Unique identifier for the Claude conversation
• Transcript path - Direct link to the conversation history
• Project context - Working directory and project name

Smart Categorization

Organize your AI sessions with predefined categories:

• 💡 Ideas Box - Brainstorming and exploration sessions
• 📋 To Do - Actionable development tasks
• 🔧 Bug Fixes - Debugging and correction sessions

Installation

From VSIX file (Recommended for private distribution)

code --install-extension idea-valorization-1.1.5.vsix

From VS Code Marketplace

Search for "Claude Code Task Manager" in the Extensions view (Ctrl+Shift+X).

Quick Start

1. Initialize Your Project

Open the Command Palette (Ctrl+Shift+P) and run:

Claude Task Manager: Initialize Project

2. Enter Your Credentials

You'll be prompted for:

• Project name - A friendly name for your project
• ClickUp API Key - Get it from ClickUp Settings → Apps → Generate API Token
• ClickUp List ID - Found in the URL: app.clickup.com/.../li/XXXXXXX

3. Start Coding with Claude

Every new Claude Code session will now prompt you to create a task!

Configuration

Access settings via File → Preferences → Settings and search for "Claude Task Manager":

How It Works

┌─────────────────┐     ┌──────────────────┐     ┌─────────────┐
│  Claude Code    │────▶│  Session Hook    │────▶│   ClickUp   │
│  Session Start  │     │  (zenity dialog) │     │   Task API  │
└─────────────────┘     └──────────────────┘     └─────────────┘
                              │
                              ▼
                        ┌──────────────────┐
                        │  Task Created    │
                        │  with metadata   │
                        └──────────────────┘

The extension creates a .claude/ directory in your project with:

• vscodeiaclaude.conf - Project configuration
• scripts/.env - API credentials (gitignored)
• scripts/clickup-task.sh - Session hook script
• settings.local.json - Claude Code hook configuration

Requirements

• VS Code 1.85.0 or higher
• Claude Code CLI installed
• ClickUp account with API access
• Linux (zenity for dialogs) - Windows/Mac support coming soon

Security

• API credentials are stored locally in .claude/scripts/.env
• The .env file is automatically added to .gitignore
• Credentials never leave your machine except for ClickUp API calls

Troubleshooting

Dialog doesn't appear

• Ensure zenity is installed: sudo apt install zenity
• Check that DISPLAY environment variable is set

Task not created

• Verify your ClickUp API key is valid
• Check the list ID is correct
• Look at .claude/scripts/debug.log for detailed logs

Slow dialog

• The extension monitors performance and logs warnings if dialogs take >3 seconds
• Check system resources if this occurs frequently

Roadmap

• [ ] Windows/Mac native dialog support
• [ ] Multiple task management platforms (Jira, Notion, Asana)
• [ ] Session summary generation via Claude API
• [ ] Task templates and custom fields
• [ ] Team collaboration features

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

License

MIT License - see LICENSE for details.

About

Created by Reinforcing Online Artificial Intelligence ltd. - Bridging AI and productivity.

Built with Claude Code, for Claude Code users.