open-wadah

Command-line interface for Wadah task boards and autonomous agent workflows.

open-wadah gives teams and AI agents a fast, scriptable way to plan, assign, and deliver work from the terminal.

Why teams use Wadah CLI

• Manage tasks, assignees, and board flow without leaving your terminal.
• Automate workflows with stable JSON output for scripts and CI.
• Power autonomous agents with scoped agent tokens.
• Keep human and agent work on the same board and process.

Install

npm install -g open-wadah

Available commands: wadah, ow, tm.

60-second quick start

1. Sign in:

wadah login

2. Open your assigned tasks:

wadah open

3. Create and move work:

wadah add "Fix login issue" --board "Main"
wadah move <task-id> <bucket-id>
wadah complete <task-id>

Default API URL is https://api.openwadah.com. Override with --api <url> or WADAH_API_URL.

Core workflows

Daily task operations

wadah list --board "Main"
wadah search "billing"
wadah view <task-id>
wadah update <task-id> --notes "Root cause + next steps"
wadah comment <task-id> "Investigating now"

Dependencies and subtasks

wadah add "Ship release notes" --blocks <task-id>
wadah subtask add <task-id> "Write tests"
wadah subtask list <task-id>
wadah subtask toggle <task-id> <subtask-id>

Board administration

wadah board create "Backend"
wadah bucket create "In Review" --board <board-id>
wadah assignee create "Cursor Agent" --type agent
wadah buckets --board "Backend" --json

Command surface

| Area | Commands | |---|---| | Auth | login, signup, logout, whoami | | Tasks | open, list, search, requested, add, view, update, move, assign, comment, complete, reopen, delete | | Subtasks | subtask list, subtask add, subtask toggle, subtask delete | | Boards & members | boards, buckets, assignees, board create/delete, bucket create/update/delete, assignee create/update/delete | | Docs | docs, doc create/show/update/delete | | Calendar | calendar, calendar add/update/delete | | Files | folders, files, folder create, mkdir, upload | | Agent tokens | agent-tokens, agent-token create/delete | | Utilities | doctor, completion bash, completion zsh, state, members, invite, config, do |

Use wadah --help or wadah <command> --help for full flags and examples.

AI agent mode

For autonomous workflows (Cursor, Claude Code, GitHub Actions):

• Create an agent token:

wadah agent-token create "My Agent"

• Set it as WADAH_AGENT_TOKEN in your environment.
• Use --json for deterministic machine output (wadah open --json).
• Optional natural-language command:

wadah do "add a task to fix onboarding bug"

wadah do requires OPENAI_API_KEY.

Global flags

• --api <url>: API base URL
• --profile <name>: config profile
• --token <token>: token for current command only
• --json: machine-readable output
• --quiet: reduce non-essential output

Environment variables

• WADAH_AGENT_TOKEN: preferred auth token for automation
• WADAH_API_URL: override API base URL
• OPENAI_API_KEY: required for wadah do

Shell completion

# Bash
wadah completion bash >> ~/.bashrc && source ~/.bashrc

# Zsh
wadah completion zsh >> ~/.zshrc && source ~/.zshrc

Development

npm test
node cli.js --help

JSON error codes

When running with --json, failures include structured error codes:

• auth_error
• validation_error
• network_error
• api_error
• config