> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiroleague.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Installing Hiro Task Manager

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](/task-manager/get-started/advanced-setup).

### 0. Pre-requisites

* You need either [bun](https://bun.sh/docs/installation) or [node.js](https://nodejs.org/en/download/), Not both.
* You can replace all **bun/bunx** commands below with **npm/npx** commands.

```bash theme={null}
bun --version
```

<Note>
  If you are getting `Command not found: bun` error, follow instructions on Bun's website to add Bun to your PATH.
</Note>

### 1. Install

```bash theme={null}
bun install -g @hiroleague/taskmanager
```

### 2. First time setup

Run `hirotaskmanager` in a terminal, preferrably a PowerShell window on Windows.

```bash theme={null}
hirotaskmanager
```

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`](https://github.com/vercel-labs/skills) package to install and update skills.

Install the skill from our repo:

```bash theme={null}
bunx skills add hiro-league/hirotaskmanager
```

**Or** Install the skill from `hirotaskmanager` folder:

```bash theme={null}
bunx skills add "$HOME/.taskmanager/skills"
```

You will have the option to:

* 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:

```bash theme={null}
hirotaskmanager server start
hirotaskmanager server stop
```

### Create a board

```bash theme={null}
hirotm boards add "Baymax Upgrade" --client "User"
hirotm boards list --format human
```

boards list Response

| Id        | Slug           | Name           | Em                    |   |   |
| --------- | -------------- | -------------- | --------------------- | - | - |
| 1         | baymax-upgrade | baymax upgrade | 🔫                    |   |   |
| **total** | **1**          | **showing 1**  | **limit 1. offset 0** |   |   |

### Create a list

```bash theme={null}
hirotm lists add --board baymax-upgrade --emoji "🔫" "Combat Tools"
hirotm lists list --board baymax-upgrade --format human
```

lists list Response

| List      | Name              | Ord                   | Color | Em | By  | Creator |
| --------- | ----------------- | --------------------- | ----- | -- | --- | ------- |
| 1         | Combat Tools      | 0                     |       | 🔫 | cli | hirotm  |
| **total** | **1 - showing 1** | **limit 1. offset 0** |       |    |     |         |

### Create a task

```bash theme={null}
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
```

Note: `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

<Prompt description="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." actions={["copy", "cursor"]}>
  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.
</Prompt>

## Updates

When new versions of `hirotaskmanager` are released, update both the taskmanager and the hirotaskmanager skill.

```bash theme={null}
bun update -g @hiroleague/taskmanager
bunx skills update skills update hiro-task-manager-cli
```

# Uninstall

```bash theme={null}
bun remove -g @hiroleague/taskmanager
bunx skills remove hiro-task-manager-cli
```

Note: use `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](/task-manager/get-started/concepts) — boards, lists, tasks, CLI access policy.
* [Advanced setup](/task-manager/get-started/advanced-setup) — VPS install, split server/CLI, hardened single-host, dev workflow.
* [hirotm CLI](/task-manager/cli/cli-commands) — global flags and subcommand reference.