cli/docs/cmd/ai/index.md

core ai

AI agent task management and Claude Code integration.

Task Management Commands

Command	Description
tasks	List available tasks from core-agentic
task	View task details or auto-select
task:update	Update task status or progress
task:complete	Mark task as completed or failed
task:commit	Create git commit with task reference
task:pr	Create GitHub PR linked to task

Claude Integration

Command	Description
claude run	Run Claude Code in current directory
claude config	Manage Claude configuration

---

Configuration

Task commands load configuration from:

1. Environment variables (AGENTIC_TOKEN, AGENTIC_BASE_URL)
2. .env file in current directory
3. ~/.core/agentic.yaml

---

ai tasks

List available tasks from core-agentic.

core ai tasks [flags]

Flags

Flag	Description
--status	Filter by status (pending, in_progress, completed, blocked)
--priority	Filter by priority (critical, high, medium, low)
--labels	Filter by labels (comma-separated)
--project	Filter by project
--limit	Max number of tasks to return (default: 20)

Examples

# List all pending tasks
core ai tasks

# Filter by status and priority
core ai tasks --status pending --priority high

# Filter by labels
core ai tasks --labels bug,urgent

---

ai task

View task details or auto-select a task.

core ai task [task-id] [flags]

Flags

Flag	Description
--auto	Auto-select highest priority pending task
--claim	Claim the task after showing details
--context	Show gathered context for AI collaboration

Examples

# Show task details
core ai task abc123

# Show and claim
core ai task abc123 --claim

# Show with context
core ai task abc123 --context

# Auto-select highest priority pending task
core ai task --auto

---

ai task:update

Update a task's status, progress, or notes.

core ai task:update <task-id> [flags]

Flags

Flag	Description
--status	New status (pending, in_progress, completed, blocked)
--progress	Progress percentage (0-100)
--notes	Notes about the update

Examples

# Set task to in progress
core ai task:update abc123 --status in_progress

# Update progress with notes
core ai task:update abc123 --progress 50 --notes 'Halfway done'

---

ai task:complete

Mark a task as completed with optional output and artifacts.

core ai task:complete <task-id> [flags]

Flags

Flag	Description
--output	Summary of the completed work
--failed	Mark the task as failed
--error	Error message if failed

Examples

# Complete successfully
core ai task:complete abc123 --output 'Feature implemented'

# Mark as failed
core ai task:complete abc123 --failed --error 'Build failed'

---

ai task:commit

Create a git commit with a task reference and co-author attribution.

core ai task:commit <task-id> [flags]

Commit message format:

feat(scope): description

Task: #123
Co-Authored-By: Claude <noreply@anthropic.com>

Flags

Flag	Description
-m, --message	Commit message (without task reference)
--scope	Scope for the commit type (e.g., auth, api, ui)
--push	Push changes after committing

Examples

# Commit with message
core ai task:commit abc123 --message 'add user authentication'

# With scope
core ai task:commit abc123 -m 'fix login bug' --scope auth

# Commit and push
core ai task:commit abc123 -m 'update docs' --push

---

ai task:pr

Create a GitHub pull request linked to a task.

core ai task:pr <task-id> [flags]

Requires the GitHub CLI (gh) to be installed and authenticated.

Flags

Flag	Description
--title	PR title (defaults to task title)
--base	Base branch (defaults to main)
--draft	Create as draft PR
--labels	Labels to add (comma-separated)

Examples

# Create PR with defaults
core ai task:pr abc123

# Custom title
core ai task:pr abc123 --title 'Add authentication feature'

# Draft PR with labels
core ai task:pr abc123 --draft --labels 'enhancement,needs-review'

# Target different base branch
core ai task:pr abc123 --base develop

---

ai claude

Claude Code integration commands.

ai claude run

Run Claude Code in the current directory.

core ai claude run

ai claude config

Manage Claude configuration.

core ai claude config

---

Workflow Example

# 1. List available tasks
core ai tasks --status pending

# 2. Auto-select and claim a task
core ai task --auto --claim

# 3. Work on the task...

# 4. Update progress
core ai task:update abc123 --progress 75

# 5. Commit with task reference
core ai task:commit abc123 -m 'implement feature'

# 6. Create PR
core ai task:pr abc123

# 7. Mark complete
core ai task:complete abc123 --output 'Feature implemented and PR created'

See Also

• dev - Multi-repo workflow commands
• Claude Code documentation