traygerbig ╔═══════════════════════════════════════════════════════╗
║ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ║
║ ┃ ╦╔═╗╔═╗╔╦╗╔═╗ ┃ ║
║ ┃ ║║ ║║ ║ ║ ║ ║ ┃ ║
║ ┃ ╚╝╚═╝╚═╝ ╩ ╚═╝ ┃ ║
║ ┃ A G E N T ┃ ║
║ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ ║
║ ║
║ [ TODO ]──>[ IN PROGRESS ]──>[ REVIEW ]──>[ DONE ] ║
║ ┃ ┃ ┃ ┃ ║
║ ▼ ▼ ▼ ▼ ║
║ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ║
║ │ 5 │ │ 3 │ │ 2 │ │12 │ ║
║ └───┘ └───┘ └───┘ └───┘ ║
╚═══════════════════════════════════════════════════════╝
skill: jooto-agent | version: 1.0.0 | platform: Jooto API v1 | tasks: unlimited | boards: multi-project
Command your entire Jooto workspace from the terminal -- create tasks, orchestrate boards, and automate team workflows without ever opening a browser.
Overview
Jooto Agent transforms your CLI into a full-featured Jooto project management cockpit. Jooto, developed by PR TIMES (a leading Japanese PR and communications platform), is one of Japan's most popular kanban-style task management tools, trusted by over 1,800 organizations including agencies, startups, and enterprise teams. This skill bridges the gap between developer workflows and project management by bringing every Jooto capability directly into your terminal session.
With Jooto Agent, you can create and manage tasks across multiple boards, assign team members, set priorities and due dates, attach files, and generate progress reports -- all through intuitive CLI commands. The skill supports advanced workflows including recurring task automation, bulk operations, label-based filtering, and cross-board analytics. Whether you are running a sprint for a software team in Tokyo or coordinating a marketing campaign across distributed offices, Jooto Agent keeps your project data at your fingertips without context-switching.
Architecture Overview
=====================
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Developer │ │ Jooto Agent │ │ Jooto API │
│ Terminal │────>│ CLI Layer │────>│ (PR TIMES) │
│ │ │ │ │ │
│ jo tasks │ │ ┌────────────┐ │ │ ┌───────────┐ │
│ jo create │ │ │ Auth Mgr │ │ │ │ Boards │ │
│ jo boards │ │ ├────────────┤ │ │ │ Tasks │ │
│ jo report │ │ │ Cmd Router │ │ │ │ Users │ │
│ │ │ ├────────────┤ │ │ │ Labels │ │
└─────────────┘ │ │ Formatter │ │ │ │ Comments │ │
│ └────────────┘ │ │ └───────────┘ │
└──────────────────┘ └─────────────────┘
│
┌────────▼────────┐
│ Local Cache │
│ ~/.jooto/ │
│ - boards.json │
│ - config.yaml │
└─────────────────┘
System Prompt Instructions
You are the Jooto Agent, an expert project management assistant specialized in Jooto (PR TIMES). Follow these rules precisely:
- Always authenticate using the
JOOTO_API_KEYenvironment variable before making any API calls. If the key is missing, prompt the user to set it and provide the URL for Jooto API key generation. - Default to the organization specified by
JOOTO_ORGANIZATION_ID. If not set, fetch and cache the user's primary organization on first run. - When creating tasks, require at minimum a title and board ID. Infer the board from context if the user has only one active board.
- Always display task status using kanban-style labels:
[TODO],[IN PROGRESS],[REVIEW],[DONE]. Map these to Jooto's internal list IDs automatically. - Format all dates in
YYYY-MM-DDformat for consistency. When the user says "tomorrow" or "next Friday," calculate the absolute date from the current system date. - When listing tasks, default to showing the current user's assigned tasks sorted by due date. Support
--allflag to show all board tasks. - Support Japanese task titles and descriptions natively. Output headers in English but preserve Japanese content as-is.
- For recurring tasks, validate the cron expression or natural-language interval before scheduling. Supported intervals: daily, weekly, biweekly, monthly, quarterly.
- When attaching files, verify the file exists locally before uploading. Enforce a 10MB file size limit per Jooto API constraints.
- Rate-limit API calls to a maximum of 60 requests per minute. Queue excess requests and notify the user of estimated wait time.
- Cache board metadata locally in
~/.jooto/boards.jsonwith a 5-minute TTL. Force refresh with--refreshflag. - For
jo report, aggregate task counts by status, assignee, and label. Calculate completion percentages and velocity metrics over the specified time range. - When updating tasks, confirm destructive changes (deletion, status regression) with the user before executing. Use
--forceto skip confirmation. - Color-code priority levels in terminal output:
[P1]red,[P2]yellow,[P3]green,[P4]gray. Fall back to text labels if the terminal does not support colors. - On any API error, display the HTTP status code, Jooto error message, and a suggested remediation action. Retry transient errors (429, 500, 502, 503) up to 3 times with exponential backoff.
- When managing team members, respect Jooto role permissions. Do not attempt admin-only operations unless the authenticated user has admin privileges.
- For export operations, support CSV, JSON, and Markdown formats. Default to CSV if no format is specified.
- Log all write operations (create, update, delete) to
~/.jooto/audit.logwith timestamps for traceability.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
JOOTO_API_KEY |
Yes | -- | API key from Jooto account settings |
JOOTO_ORGANIZATION_ID |
No | auto-detect | Organization ID for multi-org accounts |
JOOTO_DEFAULT_BOARD |
No | -- | Default board ID for task operations |
JOOTO_CACHE_TTL |
No | 300 |
Cache time-to-live in seconds |
JOOTO_LOG_LEVEL |
No | info |
Logging verbosity: debug, info, warn, error |
JOOTO_LOCALE |
No | ja |
Output locale (ja, en) |
Commands
jo tasks -- List Tasks
$ jo tasks
┌─────────────────────────────────────────────────────────────────────┐
│ Board: Website Redesign (board-4821) │
├──────┬──────────────────────────┬────────┬──────────┬──────────────┤
│ ID │ Title │ Status │ Priority │ Due Date │
├──────┼──────────────────────────┼────────┼──────────┼──────────────┤
│ 1042 │ Design hero section │ [DONE] │ [P1] │ 2026-02-28 │
│ 1043 │ Implement nav component │ [IP] │ [P1] │ 2026-03-03 │
│ 1044 │ Write product copy │ [TODO] │ [P2] │ 2026-03-05 │
│ 1045 │ QA responsive layout │ [TODO] │ [P2] │ 2026-03-07 │
│ 1046 │ Deploy staging │ [TODO] │ [P3] │ 2026-03-10 │
└──────┴──────────────────────────┴────────┴──────────┴──────────────┘
Showing 5 tasks assigned to you | Total on board: 23
jo create -- Create a Task
$ jo create --board 4821 --title "Add footer links" --priority P2 --due 2026-03-08 --assign tanaka
Task created successfully.
ID: 1047
Board: Website Redesign (board-4821)
Title: Add footer links
Priority: [P2]
Due: 2026-03-08
Assignee: Tanaka Yuki (@tanaka)
Status: [TODO]
jo boards -- List Boards
$ jo boards
┌────────┬────────────────────────┬────────┬───────────┬─────────────┐
│ ID │ Name │ Tasks │ Members │ Updated │
├────────┼────────────────────────┼────────┼───────────┼─────────────┤
│ 4821 │ Website Redesign │ 23 │ 5 │ 2026-03-01 │
│ 4805 │ Q1 Marketing Campaign │ 47 │ 8 │ 2026-02-28 │
│ 4799 │ Mobile App Sprint 3 │ 31 │ 4 │ 2026-02-27 │
│ 4788 │ Internal Tools │ 12 │ 3 │ 2026-02-25 │
└────────┴────────────────────────┴────────┴───────────┴─────────────┘
4 boards in organization: ClawHub Inc.
jo update -- Update a Task
$ jo update 1043 --status done --comment "Navigation merged in PR #287"
Task #1043 updated.
Title: Implement nav component
Status: [IN PROGRESS] -> [DONE]
Comment: "Navigation merged in PR #287" added.
Updated: 2026-03-01 14:32:05 JST
jo comments -- View or Add Comments
$ jo comments 1043
Task #1043: Implement nav component
───────────────────────────────────────
[2026-02-27 09:15] @suzuki:
Started working on this. Using shadcn/ui for base components.
[2026-02-28 16:42] @tanaka:
Looks good. Please add mobile hamburger menu too.
[2026-03-01 14:32] @ishihara:
Navigation merged in PR #287
3 comments total
jo labels -- Manage Labels
$ jo labels --board 4821
┌────────┬──────────────────┬─────────┬────────────┐
│ ID │ Label │ Color │ Task Count │
├────────┼──────────────────┼─────────┼────────────┤
│ L01 │ Bug │ red │ 4 │
│ L02 │ Feature │ blue │ 11 │
│ L03 │ Design │ purple │ 5 │
│ L04 │ Documentation │ gray │ 3 │
└────────┴──────────────────┴─────────┴────────────┘
$ jo labels create --board 4821 --name "Urgent" --color red
Label "Urgent" (L05) created on board Website Redesign.
jo recurring -- Manage Recurring Tasks
$ jo recurring create --board 4821 --title "Weekly standup notes" --interval weekly --day monday --assign team
Recurring task created.
ID: R-0012
Title: Weekly standup notes
Board: Website Redesign
Schedule: Every Monday
Assignee: All team members
Next: 2026-03-02 (Monday)
$ jo recurring list
┌────────┬──────────────────────────┬───────────┬─────────────┐
│ ID │ Title │ Interval │ Next Run │
├────────┼──────────────────────────┼───────────┼─────────────┤
│ R-0010 │ Monthly retrospective │ monthly │ 2026-03-31 │
│ R-0011 │ Daily bug triage │ daily │ 2026-03-02 │
│ R-0012 │ Weekly standup notes │ weekly │ 2026-03-02 │
└────────┴──────────────────────────┴───────────┴─────────────┘
jo report -- Generate Reports
$ jo report --board 4821 --period 2026-02
Board: Website Redesign | Period: February 2026
════════════════════════════════════════════════
Status Breakdown:
[DONE] ████████████████░░░░ 12 (52%)
[IN PROGRESS] ████░░░░░░░░░░░░░░░░ 4 (17%)
[REVIEW] ███░░░░░░░░░░░░░░░░░ 2 (9%)
[TODO] █████░░░░░░░░░░░░░░░ 5 (22%)
Team Velocity:
@tanaka 8 tasks completed (top performer)
@suzuki 5 tasks completed
@ishihara 3 tasks completed
Overdue: 1 task (#1039 - missed deadline 2026-02-25)
Avg completion time: 3.2 days
jo export -- Export Board Data
$ jo export --board 4821 --format csv --output ./tasks.csv
Exporting board "Website Redesign"...
Tasks exported: 23
Format: CSV
Output: ./tasks.csv
Size: 4.2 KB
Export complete.
jo team -- Manage Team Members
$ jo team --board 4821
┌──────────────┬───────────────────┬──────────┬──────────────┐
│ Username │ Name │ Role │ Active Tasks │
├──────────────┼───────────────────┼──────────┼──────────────┤
│ @ishihara │ Ishihara Tatsuya │ Admin │ 3 │
│ @tanaka │ Tanaka Yuki │ Member │ 6 │
│ @suzuki │ Suzuki Aoi │ Member │ 4 │
│ @yamamoto │ Yamamoto Ken │ Member │ 2 │
│ @sato │ Sato Mika │ Viewer │ 0 │
└──────────────┴───────────────────┴──────────┴──────────────┘
5 members | Board: Website Redesign
Workflow Diagram
Task Lifecycle in Jooto Agent
═════════════════════════════
┌──────────┐ jo create ┌──────────┐ jo update ┌──────────┐
│ │ ──────────────> │ │ ───────────────> │ │
│ INBOX │ │ TODO │ │ IP │
│ │ │ │ <─── jo update │ │
└──────────┘ └──────────┘ (revert) └──────────┘
│
jo update │
┌───────────────┘
▼
┌──────────┐ jo update ┌──────────┐
│ │ <────────────── │ │
│ DONE │ │ REVIEW │
│ │ │ │
└──────────┘ └──────────┘
│
▼
┌──────────────────┐
│ jo report │──> Analytics & Metrics
│ jo export │──> CSV / JSON / Markdown
└──────────────────┘
Recurring Tasks:
┌────────────┐ cron/interval ┌──────────┐
│ jo recurring│ ─────────────────> │ Auto- │──> TODO list
│ create │ │ generate │
└────────────┘ └──────────┘
Error Handling
| Error | Cause | Solution |
|---|---|---|
AUTH_001: Invalid API key |
The JOOTO_API_KEY is expired or incorrect. |
Regenerate your API key at Jooto Settings > API and update the environment variable. |
BOARD_404: Board not found |
The specified board ID does not exist or you lack access. | Run jo boards to list accessible boards. Verify the ID and your membership. |
RATE_429: Too many requests |
API rate limit of 60 requests/minute exceeded. | Wait 60 seconds or reduce batch size. The agent auto-retries with backoff. |
TASK_CONFLICT: Duplicate title |
A task with the same title already exists on the board in the same list. | Use --allow-duplicate flag or rename the task. |
FILE_TOO_LARGE: Exceeds 10MB |
Attachment file exceeds Jooto's upload limit. | Compress the file or host it externally and add a link in the task description. |
PERM_403: Insufficient privileges |
Your role (Member/Viewer) cannot perform admin operations like deleting boards. | Contact your organization admin to elevate your role, or use an admin API key. |
NET_TIMEOUT: Connection timeout |
Network issue or Jooto service is temporarily unavailable. | Check your internet connection. The agent retries up to 3 times automatically. |
FAQ
1. How do I get a Jooto API key?
Log in to Jooto, go to Settings > API Integration, and generate a new key. Copy it to your JOOTO_API_KEY environment variable.
2. Can I manage multiple organizations?
Yes. Set JOOTO_ORGANIZATION_ID to switch between organizations, or use --org <id> on any command.
3. Does Jooto Agent work with Jooto's free plan? Yes. All core task and board operations work on the free plan. Some advanced features like file attachments may be limited by your plan.
4. How do recurring tasks work? The agent uses Jooto's API scheduling or, if unavailable, creates a local cron job that generates tasks at the specified interval.
5. Can I use Japanese in task titles? Absolutely. The agent fully supports UTF-8 including Japanese, Chinese, and emoji characters in titles and descriptions.
6. Is there an offline mode? The agent caches recent board data locally. You can view cached tasks offline, but creating or updating tasks requires an active connection.
7. How do I filter tasks by label?
Use jo tasks --label Bug or jo tasks --label L01 to filter by label name or ID.
8. Can I bulk-create tasks from a CSV?
Yes. Use jo create --from-csv tasks.csv where the CSV has columns: title, priority, due_date, assignee.
9. How does the report calculate velocity? Velocity is measured as tasks moved to DONE per week, averaged over the specified reporting period.
10. Does it integrate with GitHub or Slack? Jooto Agent focuses on Jooto's API. For GitHub integration, pair it with other ClawHub skills. Jooto's native Slack integration works independently.
11. What happens if I delete a task by accident? Deleted tasks are soft-deleted in Jooto for 30 days. Contact Jooto support or check the trash in the web UI to restore.
12. Can I customize the kanban columns? The agent maps to Jooto's list structure. Create custom lists in Jooto's web UI, and the agent will recognize them automatically.
Data Storage
~/.jooto/
├── config/
│ └── config.yaml
├── cache/
│ ├── boards.json
│ └── members.json
├── exports/
│ ├── csv/
│ ├── json/
│ └── markdown/
├── recurring/
│ └── schedules.json
└── logs/
└── audit.log
All data is stored locally on disk. No data is sent to third-party services beyond the official Jooto API. API keys are stored in plaintext in the config file; for enhanced security, use environment variables instead.
Comparison Table
| Feature | Jooto Agent (CLI) | Jooto Web UI | Trello CLI | Asana CLI |
|---|---|---|---|---|
| Task CRUD | Full | Full | Full | Full |
| Bulk operations | Yes (CSV import) | Limited | No | Yes |
| Offline viewing | Yes (cache) | No | No | No |
| Japanese-native | Yes | Yes | No | No |
| Recurring tasks | Yes | Web only | No | Yes |
| CLI reports | Bar charts + metrics | Dashboard | No | Basic |
| Export formats | CSV, JSON, MD | CSV | JSON | CSV |
| PR TIMES ecosystem | Native | Native | No | No |
| Team management | Yes | Yes | Limited | Yes |
| Custom workflows | Label + priority | Drag-drop | Power-ups | Rules |
| Price | Free (OSS) | Freemium | Free | Paid |
| Setup time | 2 minutes | Browser login | 5 minutes | 10 minutes |
Jooto Agent -- because your kanban board belongs in your terminal, not your browser tab.