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
2. First time setup
Runhirotaskmanager in a terminal, preferrably a PowerShell window on Windows.
- 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 theskills package to install and update skills.
Install the skill from our repo:
hirotaskmanager folder:
- 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:Create a board
Create a list
Create a task
board describe command will help you get relevant board information.
tasks list Response
Prompt Demo
Since the CLI tool is meant for AI Agents, all the above can be created with a simple promptCreate 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 ofhirotaskmanager are released, update both the taskmanager and the hirotaskmanager skill.
Uninstall
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.
