monoban 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +49 -80
- package/dist/index.mjs +1632 -988
- package/package.json +13 -9
package/README.md
CHANGED
|
@@ -1,100 +1,69 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<a href="https://monoban.dev"><img src="https://monoban.dev/og.png" alt="monoban: your tasks, one keystroke away" width="760"></a>
|
|
3
|
+
</p>
|
|
4
|
+
|
|
1
5
|
# monoban
|
|
2
6
|
|
|
3
|
-
|
|
7
|
+
Your [monoban.dev](https://monoban.dev) board, in your terminal. Add, move and start tasks without leaving
|
|
8
|
+
the repository you're working in, script it with `--json`, and hand tasks to coding agents.
|
|
4
9
|
|
|
5
10
|
```sh
|
|
6
|
-
|
|
7
|
-
monoban
|
|
8
|
-
monoban logout
|
|
11
|
+
brew install thiagodmont/tap/monoban # macOS and Linux: a standalone binary, completions included
|
|
12
|
+
npm install -g monoban # or npx monoban, with Node 22.12+
|
|
9
13
|
```
|
|
10
14
|
|
|
11
|
-
|
|
12
|
-
without a browser, `monoban login --device` shows a code to approve at monoban.dev/panel/device on any
|
|
13
|
-
device. The sign-in is kept in your system keychain, and you can sign CLIs out in monoban.dev/panel →
|
|
14
|
-
Devices & tokens.
|
|
15
|
+
## Quick start
|
|
15
16
|
|
|
16
17
|
```sh
|
|
17
|
-
monoban
|
|
18
|
-
monoban
|
|
19
|
-
|
|
20
|
-
monoban add "
|
|
21
|
-
monoban
|
|
22
|
-
monoban
|
|
23
|
-
monoban
|
|
24
|
-
monoban
|
|
25
|
-
monoban comments MON-12 # its latest comments, oldest of them first (-n for how many)
|
|
26
|
-
monoban today # what's planned for today in every project, overdue first (or: today fri --week)
|
|
27
|
-
monoban search login bug # tasks with all the words, in every project (title, description, tag, MON-12)
|
|
28
|
-
monoban schedule MON-12 fri # plan it for a day: tomorrow, next week, +3, oct 12… (--clear takes it off)
|
|
29
|
-
monoban start MON-12 # in the repo: check out mon-12-title (from the commit you're on), move it to In progress
|
|
30
|
-
monoban move MON-12 in-progress # columns match loosely: any case, a unique prefix
|
|
31
|
-
monoban move MON-12 --to WEB # to another project (MON-12 becomes WEB-7); add a column to choose it
|
|
32
|
-
monoban move MON-12 todo --if-column-since 2026-10-14T10:00:00Z # only if it's been in its column since then
|
|
33
|
-
monoban done MON-12
|
|
34
|
-
monoban edit MON-12 # title and description in $EDITOR (or --title, -d, no editor)
|
|
35
|
-
monoban tag MON-12 bug ui # untag MON-12 bug takes one off; list --tag bug filters
|
|
36
|
-
monoban tags # the project's tags, and the shared ones
|
|
37
|
-
monoban notes # the project's notes; notes edit ($EDITOR), notes add "a line"
|
|
38
|
-
monoban attach --pr # this branch's pull request (via gh) on the task it's named after (mon-12-…)
|
|
39
|
-
monoban attach MON-12 https://… # any link; again refreshes it. detach MON-12 #54 takes it off
|
|
40
|
-
monoban rm MON-12
|
|
41
|
-
monoban open MON-12 # in the browser
|
|
18
|
+
monoban login # approve in your browser (--device for a code, over SSH)
|
|
19
|
+
monoban link SHOP # in your clone: commands here use project SHOP from now on
|
|
20
|
+
|
|
21
|
+
monoban add "Fix the flaky checkout test" -t bug
|
|
22
|
+
monoban list # the board, column by column
|
|
23
|
+
monoban start SHOP-14 # check out shop-14-fix-the-flaky-checkout-test, move it to In progress
|
|
24
|
+
monoban attach --pr # this branch's pull request, on its task (with gh)
|
|
25
|
+
monoban done SHOP-14
|
|
42
26
|
```
|
|
43
27
|
|
|
44
|
-
|
|
45
|
-
commands there use MON, in any clone of it. Elsewhere, pick the project with `-p MON` or
|
|
46
|
-
`MONOBAN_PROJECT=MON`; with a single project, that one is used. `monoban unlink` undoes a link.
|
|
47
|
-
Every command takes `--json`. Exit codes: 0 ok, 1 error, 2 usage, 4 not signed in, 5 not found.
|
|
48
|
-
|
|
49
|
-
## Run with orchestrator
|
|
50
|
-
|
|
51
|
-
Start a coding agent on a task from the board, and it works on your own machine:
|
|
28
|
+
## What it does
|
|
52
29
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
30
|
+
| | |
|
|
31
|
+
|---|---|
|
|
32
|
+
| **The board** | `list` · `add` · `show` · `move` · `done` · `edit` · `rm` · `tag` · `notes` · `open` |
|
|
33
|
+
| **Across projects** | `today` (what's planned, overdue first) · `search` · `schedule SHOP-14 fri` · `move --to` |
|
|
34
|
+
| **Your repository** | `link` · `start` (branch + In progress) · `attach --pr` |
|
|
35
|
+
| **History** | `log` (what happened to a task) · `comment` · `comments` |
|
|
36
|
+
| **Coding agents** | `setup claude` · `setup codex` · `runner` · `run` · `runs` · `agentpipe install` |
|
|
37
|
+
| **This machine** | `doctor` (what's missing, and how to fix it) · `upgrade` |
|
|
60
38
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
(its origin is the linked repository, or `monoban link` was run there), and inside `--allow` folders if you
|
|
64
|
-
set any; `--confirm` asks before each one. The task's run tab shows the steps.
|
|
39
|
+
`monoban <command> --help` says more. Columns match loosely (`move SHOP-14 in-prog`), and Tab completes
|
|
40
|
+
commands, projects, columns and tasks (`monoban completion zsh`).
|
|
65
41
|
|
|
66
|
-
|
|
42
|
+
## Coding agents
|
|
67
43
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
- Claude Code (`claude -p`, 2.1.259 or later) runs in auto mode: a classifier reviews each action, and
|
|
71
|
-
anything that would need a person is refused instead of waiting. `--budget` and `--model` apply.
|
|
72
|
-
- Codex (`codex exec`) runs in its sandbox, writing only in the folder with the network off;
|
|
73
|
-
`--access network` turns the network on and `--access full` turns the sandbox off, but only on a runner
|
|
74
|
-
that allows it (`monoban runner --allow-full-access`, or `"codex": {"allowFullAccess": true}` in
|
|
75
|
-
`runner.json`); elsewhere it stays in the sandbox and the run says so. `--model` applies.
|
|
44
|
+
**Teach yours the board.** `monoban setup claude` (or `codex`) installs a skill: when the agent plans work,
|
|
45
|
+
it offers to put the plan on your board as tasks, then keeps them current as it goes.
|
|
76
46
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
47
|
+
**Or let one do the task.** Run `monoban runner` on the machine with the code, then press `R` on a task at
|
|
48
|
+
monoban.dev (or `monoban run SHOP-14 --agent claude --follow`). The runner works in your clone: it makes
|
|
49
|
+
the task's branch, runs Claude Code, Codex or agentpipe, then pushes and opens the pull request. The task
|
|
50
|
+
shows each step as it happens. `monoban agentpipe install` installs agentpipe (macOS, or Linux with glibc),
|
|
51
|
+
and the runner offers it within a minute.
|
|
82
52
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
53
|
+
- The runner only asks monoban.dev for work: nothing reaches into your machine.
|
|
54
|
+
- It works only in a clone of the task's project (for Claude Code and Codex, one with no uncommitted
|
|
55
|
+
changes), and `--confirm` asks before each run.
|
|
56
|
+
- Claude Code runs in auto mode (a classifier reviews each action). Codex runs in its sandbox, with the
|
|
57
|
+
network only when a run asks; without the sandbox only on a runner started with `--allow-full-access`.
|
|
86
58
|
|
|
87
|
-
##
|
|
59
|
+
## Scripts and CI
|
|
88
60
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
monoban
|
|
92
|
-
|
|
61
|
+
Every command takes `--json`, results go to stdout and messages to stderr. Exit codes: `0` ok, `1` error,
|
|
62
|
+
`2` usage, `4` not signed in, `5` not found. In CI, sign in with a personal access token (made at
|
|
63
|
+
monoban.dev → Settings): `MONOBAN_TOKEN`, or `monoban login --with-token < file`. `MONOBAN_PROJECT` or
|
|
64
|
+
`-p SHOP` picks the project anywhere.
|
|
93
65
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
and keeps them current as it works. `--project` installs the skill in the repository instead (to commit
|
|
97
|
-
it for everyone), `--print` shows it, and `--remove` takes it out. Run `setup` again after upgrading
|
|
98
|
-
monoban. Claude may run the commands that only read (`list`, `show`, `tags`…) without asking.
|
|
66
|
+
Your sign-in is kept in the system keychain, and each new one is emailed to you. Sign out any computer at
|
|
67
|
+
monoban.dev → Settings.
|
|
99
68
|
|
|
100
|
-
|
|
69
|
+
MIT
|