harbor --about
Harbor, in your terminal
The same harbor as the website, full screen and by keyboard: boards, programs, risks, people, the roadmap and History, every field editable and saved as you go. Plus commands for scripts and agents. Your crew sees every change on the web within seconds.
$ npm install -g @harborppm/cliNeeds Node 22 or later. Just looking? ssh try.harborppm.com opens the app on the demo harbor: nothing to install, no account, and nothing you change is kept.
Harbor ▸ Cedar ● saved · Aya Tanaka 1 Today │ Today's focus 1 of 3 · f takes one off 2 Inbox │ RRL-4 Lock fall colorways with mill 3 Projects │ 4 Programs │ Your check-in: Frost in or out with the mill. That's the whol… 5 Risks │ On you 5 open · 1 late · f focus 6 People │ › RRL-4 Lock fall colorways with mill !! late · Nov 6 · Rid… 7 Roadmap │ RRL-5 Write landing page story ! Nov 10 · Ridge Runner la… 8 History │ RRL-3 Weekly mill check-in Nov 10 · Ridge Runner launch 9 Calendar │ OTM-5 Write App Store review notes !! Nov 12 · Offline tr… 0 Brief │ CV-4 Guest checkout copy Nov 14 · Checkout v3 C Crew │ W Your week │ Waiting on you │ Approve outsole tooling drawings waits on RRL-4 H Harbors │ Size run for press samples waits on RRL-4 : Anything │ │ Also on (others own these) │ RRL-2 Approve outsole tooling drawings Aya Tanaka │ │ Yours in the register │ risk Vibram outsole allocation slipped two weeks │ 0–9 screens : anything / find n new u undo H harbors ? keys q quit
harbor help
The dozen commands most people need. harbor help all lists every one.
- harbor
- the full-screen app, by keyboard
- harbor signup
- new to Harbor: make an account
- harbor login
- sign in (opens your browser once)
- harbor mine
- what's on you, late first
- harbor add "TITLE"
- add a task (--project P, --due DATE)
- harbor start TASK
- move a task to In play
- harbor done TASK
- finish it
- harbor tasks [words]
- find tasks across the harbor
- harbor projects
- projects with health and open work
- harbor forecast PROJECT
- when it will likely finish
- harbor brief
- late work, live risks, what shipped
- harbor open TASK
- open it on the website
one command at a time
Each command answers in a line or two, and every one takes --json for scripts. Tasks go by their key, like RRL-4. An agent can set up programs, projects and tasks end to end.
$ harbor mineAya: 5 open, 1 lateRRL-4 Lock fall colorways with mill (in play · late, due 2026-11-06 · urgent · Ridge Runner launch)RRL-5 Write landing page story (to do · due 2026-11-10 · high · Ridge Runner launch)OTM-5 Write App Store review notes (to do · due 2026-11-12 · urgent · Offline trail maps)$ harbor add "Call the mill about frost" --project ridge --due tomorrowAdded: RRL-15 Call the mill about frost (to do · due tomorrow · Ridge Runner launch)$ harbor done RRL-4Lock fall colorways with mill: done.
harbor
On its own, harbor takes over the terminal, like htop or lazygit, and gives it back when you press q. It runs on the same engine as the website: health, task keys, limits and undo work the same way, and it holds your changes while you’re offline.
- 1Today: your focus, your check-in, what's on you and who waits on you
- 2Inbox: waiting on you, sign-offs and mentions
- 3Projects: every board, list and budget; pick cards and move them together
- 4Programs: the review, worst first, with milestones and next moves
- 5Risks: the register and its heat map
- 6People: open work against each person's capacity
- 7Roadmap: programs and projects across the months
- 8History: who changed what
- 9Calendar: the month, day by day
- 0Brief: the weekly brief, or the shipping forecast
j k moveEnter open: find anything/ find a taskn newx doneu undo? every key
Colours for dark terminals and light ones, picked by asking the terminal (harbor theme light settles it).
harbor init
Keep a project’s plan beside the code: one plain file per task in a .harbor/ folder. Edit them by hand, review them in pull requests, and harbor sync sends the edits and brings the website’s back. No account? harbor init --local keeps a plan in the folder only, offline and free.
---title: Move checkout to the new APIstatus: doingowner: Sam Riveradue: 2026-11-20priority: highwaits: [CS-2]---Old endpoints go away on Nov 20.
harbor prompt
A few characters for your shell prompt, late work in coral, and nothing at all when you’re clear. It never waits on the network. harbor prompt --init zsh (or bash, fish, starship) prints the lines to add.
~/cedar-site $ ⚓ 2 today · 1 late
harbor signup
A harbor of your own is free for 30 days, no card. After that it’s $49 a month for the whole crew, not per seat. harbor signup makes your account in the browser, then harbor names your harbor and its first project. Already have one? harbor login.
$ npm install -g @harborppm/cliPrefer a browser? Try Harbor free or open the live demo. Using Claude or another AI app? Connect it over MCP.