Task management for solo builders with endless ideas and a talent for forgetting. Hiro Task Manager adds superpowers to your task lists with AI-agent access control.
Installation
This quickstart guide covers Local Setup on a single machine. For Server/Client Setup, see Advanced setup.
0. Pre-requisites
- You need either bun or node.js, Not both.
- You can replace all bun/bunx commands below with npm/npx commands.
If you are getting Command not found: bun error, follow instructions on Bun’s website to add Bun to your PATH.
1. Install
bun install -g @hiroleague/taskmanager
2. First time setup
Run hirotaskmanager in a terminal, preferrably a PowerShell window on Windows.
You will be prompted through an interactive wizard:
- Select [s] - Server mode
- Accept all defaults, change the port if you are using port 3001
- A browser window will open, create your passphrase, and login using it.
- A Recovery Key is printed once on the terminal. Store it safely
3. Add Skills
Hiro Task Manager uses the skills package to install and update skills.
Install the skill from our repo:
bunx skills add hiro-league/hirotaskmanager
hirotaskmanager folder:
bunx skills add "$HOME/.taskmanager/skills"
- Install the skill globally or to a specific project.
- Install to Cursor, Codex, Claude Code, OpenCode and 41 more agents.
CLI Usage Demo
This is not intended for human use, it only reflects the capabilities of the CLI tool and how AI Agents may intuitively use it.
Manage the server
Start/Stop Hiro Task Manager:
hirotaskmanager server start
hirotaskmanager server stop
Create a board
hirotm boards add "Baymax Upgrade" --client "User"
hirotm boards list --format human
| Id | Slug | Name | Em | | |
|---|
| 1 | baymax-upgrade | baymax upgrade | 🔫 | | |
| total | 1 | showing 1 | limit 1. offset 0 | | |
Create a list
hirotm lists add --board baymax-upgrade --emoji "🔫" "Combat Tools"
hirotm lists list --board baymax-upgrade --format human
| List | Name | Ord | Color | Em | By | Creator |
|---|
| 1 | Combat Tools | 0 | | 🔫 | cli | hirotm |
| total | 1 - showing 1 | limit 1. offset 0 | | | | |
Create a task
hirotm boards describe baymax-upgrade
hirotm tasks add --board baymax-upgrade --list 1 --group 1 --title "improve punch accuracy" --emoji "🤖" --format human --client "User"
hirotm tasks list --board baymax-upgrade --format human
board describe command will help you get relevant board information.
tasks list Response
| Task | Title | List | Status | Rel |
|---|
| 1 | improve punch accuracy | 1 | open | |
| total | 2 - showing 2 | limit 2. offset 0 | | |
Prompt Demo
Since the CLI tool is meant for AI Agents, all the above can be created with a simple prompt
Create a board called 'Baymax Upgrade', add a list 'Combat Tools', and add a task 'improve punch accuracy' as a feature, pick suitable emojis, task description as a markdown checklist.
Updates
When new versions of hirotaskmanager are released, update both the taskmanager and the hirotaskmanager skill.
bun update -g @hiroleague/taskmanager
bunx skills update skills update hiro-task-manager-cli
Uninstall
bun remove -g @hiroleague/taskmanager
bunx skills remove hiro-task-manager-cli
npm uninstall instead of bun remove if you are using node.js.
Currently, you still need to manually remove ~/.taskmanager folder, which includes your databases and other files.
What’s next?
- Concepts — boards, lists, tasks, CLI access policy.
- Advanced setup — VPS install, split server/CLI, hardened single-host, dev workflow.
- hirotm CLI — global flags and subcommand reference.
