You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
workgrid CLI (cli/): a zero-dependency client for the /api/board application service.
Output: tables on a terminal, JSON envelopes when piped or with --json.
Usability: help for every command, suggestions for mistyped commands, doctor for setup checks, and bash/zsh/fish completion.
Bulk capture is atomic and idempotent, and exit codes are stable.
Security
Plaintext HTTP is allowed only to loopback hosts. Redirects and credentials embedded in the URL are refused.
The token is read only from the environment. Response and input sizes are capped.
Terminal escape sequences and bidi characters in board text are stripped in table output and escaped in JSON.
Destructive deletes require --yes.
Agent Skill for Codex, Copilot, and Claude Code.
It ships inside the package and at .agents/skills/workgrid/SKILL.md; a test keeps the two copies identical.
workgrid skill install|status|uninstall manages it.
Installs are atomic and all-or-nothing, refuse symbolic links, and never overwrite a skill file the CLI didn't write unless --force is passed.
CI: Linux, macOS, and Windows on Node 22.13 and 24. Each run checks the package contents and smoke-tests the packed tarball.
Release: pushing a cli-v* tag creates a GitHub Release.
Assets: workgrid-cli.tgz, SHA256SUMS, and a signed build-provenance attestation.
The tagged commit must already be on main.
Nothing is published to the npm registry; the package is marked "private": true.
Actions are pinned to commit SHAs, and Dependabot updates them after a 7-day cooldown.
Podman and private-registry container builds are deliberately left out. They're on a separate branch, local-build-private-registry-podman, until they can be tested with Podman.
Test plan
npm run cli:check: 48 tests pass, and the tarball allowlist check passes.
Read-only commands and a bulk preview run against a live local instance.
The packed tarball installs into a scratch prefix, and skill install --agent all works there.
CLI workflow passes on all six OS × Node combinations.
After merging, tag cli-v0.1.0 and confirm the release assets and the attestation.
- Zero-dependency `workgrid` CLI over the /api/board application service:
TTY tables / JSON envelopes, per-command help, typo suggestions,
completions (bash/zsh/fish), `doctor`, stable exit codes, bulk capture.
- Hardened transport: loopback-only plaintext HTTP, no redirects, no URL
credentials, env-only bearer token, bounded responses, terminal-escape
and bidi sanitization of board content.
- Agent Skill for Codex, GitHub Copilot, and Claude Code, bundled in the
package and at .agents/skills/workgrid; `workgrid skill install` writes
atomically, refuses symlinks, and never clobbers foreign files.
- CI on Linux/macOS/Windows x Node 22/24; tag-driven GitHub Release with
SHA256SUMS and signed build provenance (no npm registry publish).
Actions pinned to commit SHAs; Dependabot with a 7-day cooldown.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Windows runners checked files out with CRLF, which broke SKILL.md
frontmatter parsing and would ship CRLF in a Windows-built tarball.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Medium — wrong ID reported after task creation (lib/application/board-service.ts:208): identifyChanged reports board.tasks[0], but new tasks are appended to the unfocused list, so an existing task can be reported as created.
Medium — deleting a nonexistent entity succeeds (lib/persistence/d1-board-repository.ts:70,78): the delete statements don't check affected rows, and execute() still increments the board revision and returns success.
Medium — CLI updates can overwrite concurrent edits (cli/src/commands.js:75–78,125–130): the commands read the current entity and send a full update with old values for unspecified fields, so intervening edits can be silently reverted.
The reason will be displayed to describe this comment to others. Learn more.
🟡 Changes recommended
Task and people updates can silently overwrite concurrent edits with stale data, while multi-target skill operations can leave partial changes after a filesystem failure.
…l rollback
- tasks.update / people.update accept an optional expectedRevision that the
D1 repository enforces in the same revision-gated batch as the write. The
CLI sends the revision it read, so a concurrent edit returns CONFLICT
(exit 4) instead of being silently overwritten with stale fields.
- bash/zsh completion: `workgrid completion <TAB>` was shadowed by an empty
generated case; zsh instructions now use eval after compinit, since the
bashcompinit bridge cannot be autoloaded from $fpath.
- skill install/uninstall: restore already-written targets if a later write
fails, and refuse a non-regular file at SKILL.md even with --force.
- bulk create: validate idempotency keys with the API's [A-Za-z0-9_-]
allowlist before sending the preview request.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The reason will be displayed to describe this comment to others. Learn more.
Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.
Align empty-category help with persistence behavior
cli/src/commands.js:127
The help text says --category "" clears a task's category, but the application service normalizes an empty category to General before persisting it (lib/persistence/d1-board-repository.ts:73 and :97). A user or agent following this new CLI contract cannot actually clear the category; either support an empty category end-to-end or change this description to state that empty uses General.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
workgridCLI (cli/): a zero-dependency client for the/api/boardapplication service.--json.doctorfor setup checks, and bash/zsh/fish completion.--yes..agents/skills/workgrid/SKILL.md; a test keeps the two copies identical.workgrid skill install|status|uninstallmanages it.--forceis passed.cli-v*tag creates a GitHub Release.workgrid-cli.tgz,SHA256SUMS, and a signed build-provenance attestation.main."private": true.Podman and private-registry container builds are deliberately left out. They're on a separate branch,
local-build-private-registry-podman, until they can be tested with Podman.Test plan
npm run cli:check: 48 tests pass, and the tarball allowlist check passes.skill install --agent allworks there.cli-v0.1.0and confirm the release assets and the attestation.🤖 Generated with Claude Code