Skip to main content
Here are some common interactions with Claude Code when using TaskGraph:

Starting a new project

Working on tasks

Implementing a specific task

Viewing multiple tasks

Managing subtasks

Handling changes

Completing work

Reorganizing tasks

(Agent runs: taskgraph move --from=5.2 --to=7.3)
(Agent runs: taskgraph move --from=8 --to=4.1)
(Agent runs:
)

Analyzing complexity

Viewing complexity report

Breaking Down Complex Tasks

(Agent runs: taskgraph expand --id=5)
(Agent runs: taskgraph expand --id=5 --research)

Updating Tasks with Research

(Agent runs: taskgraph update-task --id=15 --prompt="Update based on React Query v5 changes" --research)

Adding Tasks with Research

(Agent runs: taskgraph add-task --prompt="Implement user profile image uploads using Cloudinary" --research)

Research-Driven Development

Getting Fresh Information

(Agent runs: taskgraph research "Latest best practices for JWT authentication in Node.js")

Research with Project Context

(Agent runs: taskgraph research "API optimization best practices" --id=15 --files=src/api.js)

Research Before Implementation

(Agent runs: taskgraph research "React Query v5 patterns and breaking changes" --id=8)

Research and Update Pattern

(Agent runs:
  1. taskgraph research "Latest Express.js security recommendations" --id=12
  2. taskgraph update-subtask --id=12.3 --prompt="Updated with latest security findings: [research results]")

Research for Debugging

(Agent runs: taskgraph research "Common WebSocket implementation problems and solutions" --id=20 --files=src/websocket.js)

Research Technology Comparisons

(Agent runs: taskgraph research "Redis vs Memcached 2024 comparison for session caching" --tree)

Git Integration and Tag Management

Creating Tags for Feature Branches

(Agent runs: taskgraph add-tag --from-branch)

Creating Named Tags

(Agent runs: taskgraph add-tag api-v2 --description="API v2 redesign tasks")

Switching Tag Contexts

(Agent runs: taskgraph use-tag testing)

Copying Tasks Between Tags

(Agent runs: taskgraph add-tag hotfix --copy-from-current --description="Urgent hotfix tasks")

Managing Multiple Contexts

(Agent runs: taskgraph tags --show-metadata)

Tag Cleanup

(Agent runs: taskgraph delete-tag user-auth)

Working with Tag-Specific Tasks

(Agent runs: taskgraph use-tag api-v2 then taskgraph list)

Branch-Based Development Workflow

(Agent runs:
  1. git checkout feature/payments
  2. taskgraph add-tag --from-branch --description="Payment system implementation"
  3. taskgraph list to show tasks in the new context)

Parallel Feature Development

(Agent suggests and runs:
  1. taskgraph add-tag auth --description="Authentication feature tasks"
  2. taskgraph add-tag payments --description="Payment system tasks"
  3. taskgraph use-tag auth to start with authentication work)