hey — HeyStax CLI

Workspace for momentum. Spin up projects with collaborators — people and agents — in 10 seconds.

Don't just act on the next action — build towards something. Manage incidents in real time, remove the blocker of big project apps in the AI era, and build meaningfully together.

npm install heystax-cli

Requires Node.js 18+ and a HeyStax account.

Why hey

Project tools weren't built for the way work happens now. You're in the terminal, Claude Code is running, three people are shipping in parallel, and nobody wants to open a Jira board. You need a workspace that keeps up — something you spin up in seconds, not something you configure for hours.

hey is one command. Create a project, add collaborators by @handle, start logging what you're building. Every action syncs in real time to the web app, the browser extension, and AI assistants via MCP. The team sees who's doing what without a standup.

Works wherever you work:

| Where | How | |-------|-----| | Terminal | hey "message" — one command, no context switch | | Claude Code / AI | Agents read and write to your stax via MCP | | Web app | dash.heystax.ai — attention board with real-time collaboration | | Browser extension | Start Here page per project, actions synced live | | CI / scripts | Pipe failures, deploys, or events directly into a shared stax |

Quick start

hey login
hey use "my-project"
hey "Fix the token refresh race condition"
hey ls
hey done 1

Commands

Add and complete actions

| Command | Description | |---------|-------------| | hey "message" | Add a next action to your current project | | hey -x "message" | Log a breadcrumb — something you already did | | hey done [n] | Mark action #n as done (default: first action) | | hey rm <n> | Remove action #n | | hey edit <n> "text" | Edit action #n | | hey mv <from> <to> | Reorder: move action to a different position |

See what's on

| Command | Description | |---------|-------------| | hey ls | List actions for the current project | | hey ls stax | All your projects with priorities | | hey ls --all | Expanded: top 3 actions per project | | hey ls --done | Breadcrumbs — what's been completed | | hey ls -c 20 | Show up to 20 items |

Projects and context

| Command | Description | |---------|-------------| | hey use <project> | Switch default project (fuzzy matched) | | hey which | Show current project and logged-in user | | hey pri <project> <level> | Set priority: must should good meh |

Auth

| Command | Description | |---------|-------------| | hey login | Log in (interactive, password masked) | | hey logout | Log out | | hey whoami | Show current user and handle | | hey status | Session and config summary |

For individuals

Daily dev flow

# Morning: pick up exactly where you left off
hey use "backend-api"
hey ls

# Log as you go — one line, stay in the terminal
hey "Investigate N+1 query in /dashboard endpoint"
hey "Write test for edge case in token refresh"
hey -x "Fixed auth middleware — sessions now persist across restarts"

# End of day
hey ls --done

Keeping a decision log

The -x flag is for breadcrumbs: things you already did, decisions made, or context you want to preserve. They appear in the Start Here page on the extension so future-you (or a teammate) can see why the project is in its current state.

hey -x "Decided against Redis for session cache — latency was fine without it"
hey -x "Upgraded to Postgres 16 — no breaking changes, pooler config updated"
hey -x "Deprioritised dark mode until v2 — product call on 2026-03-03"

For teams — spin up a shared workspace in 10 seconds

Add collaborators to a stax and now all work is visible in one place. No Jira board, no Notion page, no standup doc — just a shared list of what's next, updated in real time from wherever each person works.

How it works

1. Create a stax or open an existing one on dash.heystax.ai
2. Set it to Collaborative from the share menu
3. Add collaborators by @handle — they get access instantly
4. Everyone runs hey use <stax-name> once
5. Actions flow in from terminal, Claude Code, CI scripts — all attributed to the right person
6. The web app shows each person's actions with a colour-coded handle pill and a filter bar

# Join a team stax
hey use "sprint-47"

# Add your actions — they'll show up under your @handle
hey "Implement OAuth handshake"
hey "Write migration for invites table"

# Log what you shipped
hey -x "Deployed API gateway — load balanced across 3 nodes"

# See the full team board
hey ls

# Check all projects
hey ls stax

Every action is visible in real time on dash.heystax.ai — no standup needed.

Incident response

When something breaks, hey gives every responder a shared log. Spin up a stax, point everyone at it, and the timeline builds itself.

# Everyone joins the incident stax
hey use "incident-2026-03-03"

# Log what you're trying in real time
hey "Check database connection pool — seeing timeouts"
hey "Rolling restart of API pods"
hey -x "Confirmed: root cause was stale connection pool config"
hey done 1

# Hand off cleanly — full timeline is in the web app
hey ls --done -c 50

AI agent governance

When multiple AI agents are running in parallel — Claude Code subagents, CI bots, automated pipelines — hey gives you a shared log of what each agent did. Point each agent at a shared stax and every action is recorded with attribution.

# Each agent logs to the shared stax
hey -x "Agent:researcher — analysed 47 files, found 3 auth patterns"
hey -x "Agent:coder — implemented OAuth flow, 312 lines changed"
hey "Agent:tester — run contract tests before merge"

The web app shows the full timeline, colour-coded by agent, so a human reviewer can see exactly what happened and what still needs sign-off.

Timesheets

Track weekly hours from the terminal. Timesheets with evidence — actions logged per day appear alongside reported hours, so approvers see what was done, not just what was claimed.

| Command | Description | |---------|-------------| | hey ts | View current week's timesheet | | hey ts 8 | Set Mon-Fri to 8h each | | hey ts wed 7.5 | Set single day hours | | hey ts mon=8 tue=7 fri=6 | Matrix input — multiple days at once | | hey ts submit | Submit current week for approval | | hey ts reopen | Reopen a submitted timesheet | | hey ts ls | List past 8 weeks |

# Friday afternoon: log your week
hey ts 8                     # 8h Mon-Fri
hey ts fri 6                 # actually left early Friday
hey ts submit                # done

Claude Code and MCP

hey + Claude Code turns your stax into a programmable task queue. Claude reads your stax, reasons about priorities, and acts on them.

Read my current stax using `hey ls --all` and write a short standup update
I can paste into Slack. Group by project, highlight the top action per project,
and flag anything that's been sitting for more than 3 days.

Run `hey ls stax` to see all my projects. For any project at 6+ actions,
suggest which actions could be combined, deferred, or done first.

# Auto-log CI failures into a shared stax
hey "CI failed: $(git log -1 --pretty='%s') — $(git rev-parse --short HEAD)"

Features

• 7-action limit per project keeps lists focused and forces prioritisation (--force to bypass)
• Fuzzy project matching — hey use tab matches "TabStax Backend"
• Priority icons — ★ must · ◆ should · ○ good · · meh
• Breadcrumbs (-x) — log decisions and completed work, not just what's next
• @handle attribution — every action tagged to you; colour-coded pills in web + extension
• Shared stax — collaborative workspaces, spun up in seconds
• Focus sessions — Play/Pause/Done timer with tracked time on timesheets
• Auto session refresh — stays logged in across restarts; prompts cleanly on expiry
• Works in CI/scripts — no interactive mode required

Links

• HeyStax
• Dashboard
• Chrome Web Store
• GitHub
• Issues

License

MIT