Skip to content
/ doyaken-cli Public

A standalone multi-project autonomous agent CLI that works with any AI coding agent. Install once, use on any project.

doyaken.ai
0 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

mitchellfyi/doyaken-cli

BranchesTags

Repository files navigation

Doyaken

A standalone multi-project autonomous agent CLI that works with any AI coding agent. Install once, use on any project.

Aliases: doyaken, dk

Features

  • Agent Agnostic: Works with Claude, Codex, Gemini, Copilot, or OpenCode
  • Multi-Project Support: Manage multiple projects from a single global installation
  • 8-Phase Execution: Expand → Triage → Plan → Implement → Test → Docs → Review → Verify
  • Self-Healing: Automatic retries, model fallback, crash recovery
  • Parallel Agents: Multiple agents can work simultaneously with lock coordination
  • Skills System: Reusable prompts with MCP tool integration
  • MCP Integration: Connect to GitHub, Linear, Slack, Jira via MCP tools
  • Project Registry: Track projects by path, git remote, domains, and services

Installation

Option 1: npm (Recommended)

# Install globally
npm install -g @doyaken/doyaken

# Or use npx without installing
npx doyaken --help

Option 2: curl (Per-User)

curl -sSL https://raw.githubusercontent.com/mitchellfyi/doyaken-cli/main/install.sh | bash

Option 3: Clone & Install

git clone https://github.com/mitchellfyi/doyaken-cli.git
cd doyaken-cli
./install.sh

Quick Start

# Initialize a new project
cd /path/to/your/project
dk init

# Create a task
dk tasks new "Add user authentication"

# Run the agent
dk run 1     # Run 1 task
dk           # Run 5 tasks (default)

# Check status
dk status    # Project status
dk tasks     # Show taskboard
dk doctor    # Health check

Commands

Command Description
dk Run 5 tasks in current project
dk run [N] Run N tasks
dk task "<prompt>" Create and immediately run a single task
dk init [path] Initialize a new project
dk tasks Show taskboard
dk tasks new <title> Create a new task
dk tasks view <id> View a specific task
dk skills List available skills
dk skill <name> Run a skill
dk mcp status Show MCP integration status
dk mcp configure Generate MCP configs
dk status Show project status
dk list List all registered projects
dk manifest Show project manifest
dk doctor Health check
dk help Show help

Note: doyaken and dk are interchangeable.

Multi-Agent Support

Doyaken supports multiple AI coding agents. Use --agent to switch between them:

dk --agent claude run 1      # Use Claude (default)
dk --agent cursor run 1      # Use Cursor
dk --agent codex run 1       # Use OpenAI Codex
dk --agent gemini run 1      # Use Google Gemini
dk --agent copilot run 1     # Use GitHub Copilot
dk --agent opencode run 1    # Use OpenCode

Supported Agents & Models

Agent Command Models Install
claude (default) claude opus, sonnet, haiku npm i -g @anthropic-ai/claude-code
cursor cursor agent claude-sonnet-4, gpt-4o curl https://cursor.com/install -fsS | bash
codex codex exec gpt-5, o3, o4-mini npm i -g @openai/codex
gemini gemini gemini-2.5-pro, gemini-2.5-flash npm i -g @google/gemini-cli
copilot copilot claude-sonnet-4.5, gpt-5 npm i -g @github/copilot
opencode opencode run claude-sonnet-4, gpt-5 npm i -g opencode-ai

Specifying Models

dk --agent codex --model o3 run 1
dk --agent gemini --model gemini-2.5-flash run 2

Agent Workflow

The agent operates in 8 phases for each task:

Phase Timeout Purpose
EXPAND 2min Expand brief prompt into full task specification
TRIAGE 2min Validate task, check dependencies
PLAN 5min Gap analysis, detailed planning
IMPLEMENT 30min Execute the plan, write code
TEST 10min Run tests, add coverage
DOCS 5min Sync documentation
REVIEW 10min Code review, create follow-ups
VERIFY 3min Verify task management, commit

Parallel Execution

Run multiple agents simultaneously:

dk run 5 &
dk run 5 &
dk run 5 &

Agents coordinate via lock files in .doyaken/locks/ and will not work on the same task.

Skills

Skills are reusable prompts with YAML frontmatter that declare tool requirements:

# List available skills
dk skills

# Run a skill
dk skill github-import --filter=open

# Show skill info
dk skill github-import --info

Built-in Skills

Quality & Audits:

Skill Description
setup-quality Set up quality gates, CI, and git hooks
check-quality Run all quality checks and report issues
audit-security OWASP-based security audit
audit-deps Audit dependencies for vulnerabilities
audit-debt Technical debt assessment
audit-performance Performance analysis
audit-ux User experience audit

Development:

Skill Description
review-codebase Comprehensive codebase review
research-features Discover next best feature to build
ci-fix Diagnose and fix CI/CD failures
workflow Run the 8-phase task workflow
sync-agents Sync agent config files to project

Integrations (require MCP servers):

Skill Description Requires
github-import Import GitHub issues as tasks GitHub MCP
github-sync Sync task status to GitHub GitHub MCP
github-pr Create PR from recent commits GitHub MCP
notify-slack Send Slack notifications Slack MCP
mcp-status Check MCP integration status -

Creating Custom Skills

Create a .md file in ~/.doyaken/skills/ (global) or .doyaken/skills/ (project):

---
name: my-skill
description: What this skill does
requires:
  - github                     # MCP servers needed
args:
  - name: filter
    description: Filter option
    default: "open"
---

# My Skill Prompt

Instructions for the AI agent...

MCP Integration

Doyaken supports MCP (Model Context Protocol) tools for external integrations:

# Show integration status
dk mcp status

# Generate MCP configs for enabled integrations
dk mcp configure

Enabling Integrations

Edit .doyaken/manifest.yaml:

integrations:
  github:
    enabled: true
  linear:
    enabled: false
  slack:
    enabled: false
  jira:
    enabled: false

After enabling, run dk mcp configure to generate the MCP configuration.

Supported Integrations

Integration Description Required Env Var
GitHub Issues, PRs, repos GITHUB_TOKEN
Linear Issues, projects LINEAR_API_KEY
Slack Messages, channels SLACK_BOT_TOKEN
Jira Issues, sprints JIRA_API_TOKEN

Skill Hooks

Auto-run skills at specific workflow points:

# In manifest.yaml
skills:
  hooks:
    before-triage:
      - github-import       # Sync issues before starting
    after-verify:
      - github-sync         # Update issues after completion

Project Structure

After running dk init, your project will have:

your-project/
├── .doyaken/
│   ├── manifest.yaml        # Project configuration
│   ├── tasks/
│   │   ├── 1.blocked/       # Blocked tasks
│   │   ├── 2.todo/          # Ready to start
│   │   ├── 3.doing/         # In progress
│   │   └── 4.done/          # Completed
│   ├── logs/                # Execution logs
│   ├── state/               # Session recovery
│   └── locks/               # Parallel coordination
├── AGENT.md                 # Project-specific agent notes
└── TASKBOARD.md             # Generated task overview

Project Manifest

Configure your project in .doyaken/manifest.yaml:

project:
  name: "my-app"
  description: "My awesome app"

git:
  remote: "git@github.com:user/my-app.git"
  branch: "main"

domains:
  production: "https://my-app.com"
  staging: "https://staging.my-app.com"

quality:
  test_command: "npm test"
  lint_command: "npm run lint"

agent:
  name: "claude"
  model: "opus"
  max_retries: 2

Task System

Task Priority

Tasks use the naming format PPP-SSS-slug.md:

Priority Code Use For
Critical 001 Blocking, security, broken
High 002 Important features, bugs
Medium 003 Normal work
Low 004 Nice-to-have, cleanup

Example: 002-001-add-user-auth.md = High priority, first in sequence

Creating Tasks

# Via CLI
dk tasks new "Add user authentication"

# Manually create in .doyaken/tasks/todo/
# Use the template format

Environment Variables

Variable Default Description
DOYAKEN_AGENT claude AI agent to use
DOYAKEN_MODEL agent-specific Model for the selected agent
DOYAKEN_AUTO_TIMEOUT 60 Auto-select menu options after N seconds (0 to disable)
AGENT_DRY_RUN 0 Preview without executing
AGENT_VERBOSE 0 Detailed output
AGENT_QUIET 0 Minimal output
AGENT_MAX_RETRIES 2 Retries per phase
TIMEOUT_EXPAND 300 Expand phase timeout (seconds)
TIMEOUT_TRIAGE 180 Triage phase timeout (seconds)
TIMEOUT_PLAN 300 Plan phase timeout (seconds)
TIMEOUT_IMPLEMENT 1800 Implement phase timeout (seconds)
TIMEOUT_TEST 600 Test phase timeout (seconds)
TIMEOUT_DOCS 300 Docs phase timeout (seconds)
TIMEOUT_REVIEW 600 Review phase timeout (seconds)
TIMEOUT_VERIFY 300 Verify phase timeout (seconds)
DOYAKEN_HOME ~/.doyaken Global installation directory

Troubleshooting

# Health check
dk doctor

# View logs
ls -la .doyaken/logs/

# Reset stuck state
rm -rf .doyaken/locks/*.lock
mv .doyaken/tasks/doing/*.md .doyaken/tasks/todo/

Development

Setup

git clone https://github.com/mitchellfyi/doyaken-cli.git
cd doyaken-cli

# Install git hooks
npm run setup

# Run all checks
npm run check

Quality Scripts

Script Description
npm run lint Lint shell scripts with shellcheck
npm run validate Validate YAML files
npm run test Run test suite
npm run check Run all quality checks
npm run setup Install git hooks

Git Hooks

The repository includes git hooks for quality assurance:

  • pre-commit: Lints staged shell scripts and YAML files
  • pre-push: Runs the full test suite

To bypass temporarily: git commit --no-verify

Requirements

License

MIT

About

A standalone multi-project autonomous agent CLI that works with any AI coding agent. Install once, use on any project.

doyaken.ai

Resources

Readme

Contributing

Contributing
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 11

v0.1.10 Latest
Jan 28, 2026
+ 10 releases

Packages

No packages published

Contributors 2

  •  
  •  

Languages