modboard 0.5.1 → 0.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/.claude-plugin/plugin.json +5 -5
- package/CHANGELOG.md +99 -0
- package/README.md +559 -366
- package/ROADMAP.md +48 -0
- package/bin/board.mjs +54 -17
- package/hooks/blocks/board.tsx +23 -0
- package/hooks/blocks/clock.tsx +1 -1
- package/hooks/blocks/compact.tsx +49 -0
- package/hooks/blocks/context.tsx +1 -0
- package/hooks/blocks/effort.tsx +9 -10
- package/hooks/blocks/index.ts +4 -1
- package/hooks/blocks/meter.tsx +29 -0
- package/hooks/blocks/model.tsx +9 -10
- package/hooks/blocks/summary.tsx +46 -29
- package/hooks/blocks/taskfile.tsx +130 -0
- package/hooks/blocks/tasks.tsx +117 -26
- package/hooks/blocks/types.tsx +15 -3
- package/hooks/blocks/usage.tsx +21 -30
- package/hooks/register.tsx +218 -28
- package/lib/contract.mjs +12 -0
- package/lib/engine.mjs +22 -1
- package/lib/taskfile.mjs +151 -0
- package/package.json +2 -2
- package/types/index.d.ts +8 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "modboard",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "A task board several agents share: Claude tools, a live pane and lease heartbeats over an agent-neutral CLI",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Magithar",
|
|
@@ -19,14 +19,14 @@
|
|
|
19
19
|
"band": {
|
|
20
20
|
"type": "string",
|
|
21
21
|
"title": "Band blocks",
|
|
22
|
-
"description": "Blocks on the one line above the prompt, in order, comma-separated: summary, usage, model, effort, clock, context, or your own from Your own blocks.",
|
|
23
|
-
"default": "summary,
|
|
22
|
+
"description": "Blocks on the one line above the prompt, in order, comma-separated: summary, board (a button that opens the pane), usage, compact, model, effort, clock, context, or your own from Your own blocks.",
|
|
23
|
+
"default": "summary,model,effort,board"
|
|
24
24
|
},
|
|
25
25
|
"pane": {
|
|
26
26
|
"type": "string",
|
|
27
27
|
"title": "Pane blocks",
|
|
28
|
-
"description": "Blocks in the /board pane, in order, comma-separated: tasks, usage, model, effort, clock, context, agents, or your own from Your own blocks.",
|
|
29
|
-
"default": "tasks,usage"
|
|
28
|
+
"description": "Blocks in the /board pane, in order, comma-separated: tasks, taskfile (the project's task.md, behind a button), compact (context bar and a compact button), usage, model, effort, clock, context, agents, or your own from Your own blocks.",
|
|
29
|
+
"default": "tasks,taskfile,compact,usage"
|
|
30
30
|
},
|
|
31
31
|
"blocks": {
|
|
32
32
|
"type": "string",
|
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,105 @@
|
|
|
3
3
|
All notable changes to modboard. Versions follow [semantic versioning](https://semver.org/).
|
|
4
4
|
modboard was called agent-board until 0.5.0.
|
|
5
5
|
|
|
6
|
+
## 0.6.0 — 2026-11-20
|
|
7
|
+
|
|
8
|
+
Sessions name themselves, the board shows your project's own task file with
|
|
9
|
+
its priorities, and the display is quieter and clickable: colour, marks and
|
|
10
|
+
words appear only where they tell you something.
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- **Sessions are named for you**, by what they run and when they joined:
|
|
15
|
+
`claude 1`, `claude 2`, `codex 1`. Nothing to set: a Claude session joins
|
|
16
|
+
when it starts, and a Codex thread when it first runs `board` (Codex marks
|
|
17
|
+
its shells with `CODEX_THREAD_ID`). A session keeps its name while it's
|
|
18
|
+
open; a new one takes the lowest free number. `BOARD_AGENT` still picks a
|
|
19
|
+
name of your own. New `board join` and `board whoami` commands.
|
|
20
|
+
- **Your task.md on the board.** When the project has a `task.md`,
|
|
21
|
+
`tasks.md` or `todo.md` (upper or lower case) at its root or in `docs/`,
|
|
22
|
+
the pane shows what's left in it under **To do**, read again on each
|
|
23
|
+
click. Checked-off items stay out. Nothing in it is claimed or written; to
|
|
24
|
+
work an item through the board, `board add` it.
|
|
25
|
+
- **Task file priorities.** P0–P9 are read from headings (`## P0 — …`,
|
|
26
|
+
`## Sync (P1)`), from items (`- [ ] P2 …`, which wins over its heading)
|
|
27
|
+
and from tables with a Priority column. A priority button beside To do
|
|
28
|
+
turns through the tiers the file has, `P0`, `P1`, …, `all`, the way the
|
|
29
|
+
effort button turns through levels. `all` lists every item with its
|
|
30
|
+
priority, unprioritised ones last, marked with a dash.
|
|
31
|
+
- **`board taskfile`** prints the task file's items; `--json` gives them as
|
|
32
|
+
data. It reads no board and writes nothing.
|
|
33
|
+
- **A `compact` block**: the context window as a bar, like the 5-hour
|
|
34
|
+
limit's, and a button that compacts the conversation, the call `/compact`
|
|
35
|
+
makes. It shows from the start: Claude Code's own estimate until the first
|
|
36
|
+
reply, then each reply's measurement.
|
|
37
|
+
- **A `modBOARD` button on the band**, bold in the logo's green, at the
|
|
38
|
+
line's right end. It opens the `/board` pane, and closes it when it's
|
|
39
|
+
open. On a short line, model and effort drop before it.
|
|
40
|
+
- **Collapsible groups.** In progress, Unfinished, Not started and Done are
|
|
41
|
+
each a heading you click to open or close, with a count: `▾ In progress ·
|
|
42
|
+
3`. What needs you starts open; Not started and Done start closed.
|
|
43
|
+
- **A Done group** lists what's finished, latest first, and who finished it.
|
|
44
|
+
- **A Limits heading** over the context and 5-hour bars, which folds like
|
|
45
|
+
the groups. Folded, it keeps the figures: `▸ Limits · context 72% ·
|
|
46
|
+
5-hour 64%`, each yellow or red as its bar would be.
|
|
47
|
+
- **A red line when the board stops answering**: `board not updating: …`
|
|
48
|
+
at the top of the pane, with the reason, until the `board` CLI answers
|
|
49
|
+
again.
|
|
50
|
+
- **A taller `/board` pane**, room for the whole board. Where the surface
|
|
51
|
+
gives less, the pane scrolls with the mouse wheel.
|
|
52
|
+
- **A tutorial**, [docs/TUTORIAL.md](docs/TUTORIAL.md): from install to two
|
|
53
|
+
agents sharing a board, reading the display, your task.md, other agents,
|
|
54
|
+
settings, and what to do when something looks wrong.
|
|
55
|
+
- **A roadmap**, [ROADMAP.md](ROADMAP.md), starting with `/board colours`.
|
|
56
|
+
- **A logo**, at the top of the README.
|
|
57
|
+
|
|
58
|
+
### Changed
|
|
59
|
+
|
|
60
|
+
- **Default blocks.** The band is now `summary,model,effort,board`; the
|
|
61
|
+
5-hour limit and the context moved to the pane, which is
|
|
62
|
+
`tasks,taskfile,compact,usage`.
|
|
63
|
+
- **A shorter band**: `2 waiting · 1 active [T-005] Sonnet 5.5 low`.
|
|
64
|
+
`active` is green, and the model and effort lose their labels.
|
|
65
|
+
- **Each unfinished task is a yellow box on the band**: `[T-005] [T-008]`,
|
|
66
|
+
up to three, then `+N`. A box is a button: it opens `/board` at
|
|
67
|
+
Unfinished, and pressed again folds the group. It replaces "T-005 stopped
|
|
68
|
+
partway, pick it up".
|
|
69
|
+
- **A claim gone idle leaves the band**, since its lease frees it on its
|
|
70
|
+
own; in the pane its row reads `codex 1 · idle`, in yellow.
|
|
71
|
+
- **"Needs picking up" is now "Unfinished"**, and its handoff shows under
|
|
72
|
+
each task as points, one per part the agent separated with a semicolon.
|
|
73
|
+
It replaces "see its note". Handoffs are now asked for as "done X; left Y;
|
|
74
|
+
see Z".
|
|
75
|
+
- **A quieter pane.** It opens with `modBOARD`, this session's name and the
|
|
76
|
+
counts. Rows lose their ◐/○ mark and name only who (`claude 2`, `you`),
|
|
77
|
+
since the heading says what. IDs are grey. A heading's name is a bold
|
|
78
|
+
button and its count grey beside it. Each open group has room around it,
|
|
79
|
+
and a grey rule parts the board, To do and the bars.
|
|
80
|
+
- **Colour only when something needs you**: yellow from 70%, red from 90%.
|
|
81
|
+
With room left, usage and context stay plain (usage used to be green).
|
|
82
|
+
- **The weekly limit is left off the board**; `/usage` has it.
|
|
83
|
+
- **The clock** in the pane is dimmed instead of bold.
|
|
84
|
+
|
|
85
|
+
### Reading task files
|
|
86
|
+
|
|
87
|
+
- Tables are read when they have a task column and a priority or status
|
|
88
|
+
column; a status of done, complete or ✅ counts as checked off.
|
|
89
|
+
- Struck-through items (`~~old plan~~`) count as done.
|
|
90
|
+
- Once a file checks anything off, its plain bullets are notes, not tasks,
|
|
91
|
+
and are left out.
|
|
92
|
+
- Markdown marks (`**`, backticks, link syntax) and status emoji are taken
|
|
93
|
+
off item text and headings for display.
|
|
94
|
+
- A broken link named `task.md` reads as no task file, not an error.
|
|
95
|
+
|
|
96
|
+
### Docs
|
|
97
|
+
|
|
98
|
+
- The README is reorganised: what it does, a demo, a three-step quick
|
|
99
|
+
start, everyday commands, what you see, settings, how it works, then
|
|
100
|
+
making your own blocks, with reference material folded away.
|
|
101
|
+
- Screenshots of the `/board` pane and the task file, and a sharper live
|
|
102
|
+
demo, re-recorded at retina resolution with the automatic names.
|
|
103
|
+
- The diagrams show the new names and groups, in the logo's green.
|
|
104
|
+
|
|
6
105
|
## 0.5.1 — 2026-11-19
|
|
7
106
|
|
|
8
107
|
Docs and package details only. The code is the same as 0.5.0.
|