Skip to main content

​
Claude Code Integration

GitHub Repository

View source code and contribute on GitHub
 This document describes how to integrate AnyTask with Claude Code using the AnyTask Claude Code Plugin.

​
Overview

The AnyTask Claude Code Plugin seamlessly integrates AnyTask’s powerful task management system directly into your Claude Code workflow. The plugin provides:
  • Slash Commands: Explicit commands for creating tasks and getting recommendations
  • Automatic Skills: Background skills that activate based on conversation context
  • Intelligent Task Creation: Create tasks with full metadata through conversational interface
  • AI-Powered Suggestions: Get smart recommendations for your next task
  • Active Task Tracking: Automatically pick and track tasks you’re working on
  • Context Loading: Automatic task details when you mention task identifiers
  • Seamless Workflow: All actions happen within Claude Code - no context switching

​
Prerequisites

  1. AnyTask CLI Installed: The plugin requires the anyt CLI
  2. Authentication Configured: Set up your API key
  3. Workspace Initialized: Have a workspace set up in your project

​
Setup Instructions

​
Step 1: Install AnyTask CLI

# Recommended: Install script
curl -fsSL https://anyt.dev/install.sh | sh
For other installation methods, see the Installation Guide.

​
Step 2: Configure AnyTask

Set up authentication and initialize workspace: 
# Set API key
export ANYT_API_KEY=anyt_agent_xxxxxxxxxxxxx

# Initialize workspace in your project
anyt init --workspace-id 123 --identifier DEV

# Verify connection
anyt health check

​
Step 3: Install the Plugin

The AnyTask Claude Code plugin is available at: https://github.com/anyt-ai/anyt-claude Install it in Claude Code: 
# Add the AnyTask plugin marketplace
/plugin marketplace add anyt-ai/anyt-claude

# Install the plugin
/plugin install anytask@anytask
That’s it! The plugin is now ready to use.

​
Usage

​
Slash Commands

​
/anytask:create - Create New Task

Create a new task in AnyTask with full control over all task properties. Example: 
User: /anytask:create
Claude: I'll help you create a new task. What would you like the task title to be?
User: Implement OAuth callback
Claude: Great! What's the description for this task?
User: Add OAuth2.0 callback handler for Google authentication
Claude: What priority should this task have? (-2 to 2, where 2 is highest)
User: 1
Claude: ✅ Created task DEV-42: Implement OAuth callback

​
/anytask:next - Get Next Task Recommendation

Get intelligent AI-powered suggestions for your next task and start working on it. Example: 
User: /anytask:next
Claude: Let me get task suggestions for you...

Top Task Recommendations:
1. DEV-42: Implement OAuth callback
   Priority: 1 | Status: todo
   Dependencies: All ready ✓

2. DEV-43: Add rate limiting
   Priority: 0 | Status: todo
   Blocked by: DEV-42 ⏸️

Would you like to start working on DEV-42?

​
Automatic Skills

Skills work in the background and activate automatically when relevant:

​
Task Creator Skill

Detects when you describe work that should be tracked as a task. Example: 
User: I need to add user authentication with OAuth
Claude: That sounds like something we should track as a task. Would you like me to create a task for this?

​
Workflow Skill

Manages task workflow by detecting completions and suggesting next steps. Example: 
User: I've finished implementing the OAuth callback
Claude: Great! Let me mark DEV-42 as done and suggest your next task...
✅ Marked DEV-42 as done
Next suggestion: DEV-43: Add rate limiting (now unblocked)

​
Context Skill

Loads task details automatically when you mention task identifiers. Example: 
User: What's the status of DEV-42?
Claude: [Automatically loads task details]
DEV-42: Implement OAuth callback
Status: in_progress
Priority: 1
Assigned to: You
Created: 2 days ago

​
Common Workflows

​
Daily Development Workflow

User: /anytask:next
Claude: Top recommendation: DEV-42: Implement OAuth callback

User: Let's work on that
Claude: Starting work on DEV-42...

[You implement the feature]

User: I've finished the OAuth implementation
Claude: Great! Let me mark DEV-42 as done and suggest next steps...
✅ DEV-42 marked as done
Next: DEV-43: Add rate limiting (now unblocked)

​
Creating Tasks from Conversations

User: We need to add rate limiting to the API
Claude: [task-creator skill activates]
That sounds like important work. Should I create a task for adding rate limiting?

User: Yes please
Claude: Creating task...
✅ Created DEV-43: Add rate limiting to API
Priority: 1 | Status: todo

​
Checking Task Status

User: What tasks are in progress?
Claude: [Loads task list]
Current in-progress tasks:
- DEV-42: Implement OAuth callback (You)
- DEV-45: Update documentation (Alice)

​
Plugin Features

​
Slash Commands vs Skills

Slash Commands (/anytask:create, /anytask:next):
  • Explicitly invoked by you
  • Always execute when called
  • Direct control over actions
  • Best for intentional task management
Skills (task-creator, task-workflow, task-context):
  • Automatically activate based on context
  • Work in the background
  • Proactive assistance
  • Best for seamless workflow integration

​
Task State Tracking

The plugin maintains awareness of:
  • Your active task
  • Recently completed tasks
  • Available tasks to work on
  • Task dependencies and blockers
This enables intelligent suggestions and workflow automation.

​
Behind the Scenes

The plugin works with your local AnyTask CLI installation:
  1. Uses CLI Commands: All operations use anyt CLI commands
  2. Workspace Aware: Works with your initialized workspace in .anyt/
  3. Active Task Tracking: Maintains active task state
  4. Context Persistence: Remembers your workflow across sessions
Example CLI calls made by the plugin: 
anyt task add "Implement OAuth" --priority 1
anyt task pick DEV-42
anyt task done DEV-42
anyt task suggest --limit 3

​
Troubleshooting

​
Plugin not working

Check plugin installation: 
/plugin list
Should show anytask in the list.

​
”CLI not found” errors

Ensure AnyTask CLI is installed and in PATH: 
which anyt
anyt --version

​
“Not in workspace” errors

Initialize workspace in your project: 
cd /path/to/your/project
anyt init --workspace-id 123 --identifier DEV

​
Authentication errors

Verify API key is set: 
echo $ANYT_API_KEY
anyt health check

​
Commands not responding

Reinstall the plugin: 
/plugin uninstall anytask
/plugin install anytask@anytask

​
Development

​
Testing the Plugin Locally

For development and testing:
  1. Clone the repository: 
    git clone https://github.com/anyt-ai/anyt-claude
cd anyt-claude
  2. Install in Claude Code: 
    /plugin install .
  3. Test the commands: 
    /anytask:create
/anytask:next
  4. After making changes, reinstall: 
    /plugin uninstall anytask
/plugin install .

​
Contributing

We welcome contributions! To add new commands or improve existing ones:
  1. Fork the repository at https://github.com/anyt-ai/anyt-claude
  2. Create a new command file in .claude-plugin/commands/ or skill in .claude-plugin/skills/
  3. Update plugin.json to register the command/skill
  4. Test thoroughly with Claude Code
  5. Submit a pull request

​
Plugin Structure

.claude-plugin/
├── plugin.json              # Plugin manifest
├── marketplace.json         # Marketplace configuration
├── commands/                # Slash commands (user-invoked)
│   ├── create.md           # /anytask:create command
│   └── next.md             # /anytask:next command
├── skills/                  # Skills (model-invoked)
│   ├── task-creator.md     # Automatic task creation
│   ├── task-workflow.md    # Workflow management
│   └── task-context.md     # Context loading
└── README.md               # Full documentation

​
Command Files

Commands are defined in Markdown files that Claude Code executes: Example: create.md 
You are helping the user create a new task in AnyTask.

1. Ask for task title
2. Ask for description (optional)
3. Ask for priority (-2 to 2)
4. Create the task using: anyt task add "<title>" --description "<desc>" --priority <p>
5. Confirm creation with task identifier

​
Skill Files

Skills activate automatically based on conversation patterns: Example: task-creator.md 
Detect when the user describes work that should be tracked.
Patterns: "we need to...", "I should...", "todo: ..."
Suggest creating a task for tracking.

​
Best Practices

​
Use Slash Commands for Explicit Actions

When you want direct control: 
/anytask:create    # When you know you need a task
/anytask:next      # When you want suggestions

​
Let Skills Work in Background

For seamless workflow:
  • Describe your work naturally
  • Skills will suggest task creation when appropriate
  • Skills will track completions automatically

​
Keep Workspace Initialized

Ensure .anyt/ directory exists in your project: 
anyt init --workspace-id 123 --identifier DEV

​
Use Descriptive Task Titles

Good: “Implement OAuth2.0 callback handler” Bad: “Fix auth” This helps with AI-powered suggestions and context loading.

​
Next Steps

​
Support

For issues or questions:
  1. Check the troubleshooting section
  2. GitHub Issues: https://github.com/anyt-ai/anyt-claude/issues
  3. Run anyt health check to diagnose CLI issues
  4. Email: [email protected]