Paseo Workboard

中文 · User guide · 中文使用指南

Workboard is a Paseo kanban plugin for workspaces and ideas. Each active workspace becomes one task. You can also capture a title-only draft first, then create or attach its workspace when you are ready to start.

Highlights

• Import existing workspaces automatically, with one workspace represented by one task.
• Keep drafts without a workspace, directory, Agent, or conversation.
• Use groups and managed workspace labels as the task status; move cards or change a native label to update the same status.
• See Agent activity separately from task status. An Agent finishing does not complete a task.
• Follow Paseo's desktop language for Chinese and English UI text and dates.
• Review compact PR/MR, CI, and review-decision information supplied by Paseo.
• Reorder, resize, collapse, color, and locate desktop columns without changing task data. Narrow layouts use a single-group view and status menu.
• Optionally archive eligible completed or canceled workspaces after 30 days from their last verified conversation.

Compatibility and trust

paseo-workboard@0.1.0 is verified for Paseo app and daemon 0.9.1. Its plugin manifest intentionally requires =0.9.1.

Paseo 0.9.1 exposes label reads through the public plugin SDK, but not label writes. Workboard therefore uses a version-specific internal bridge for its label and workspace operations. The bridge reuses the host session and must be revalidated when Paseo changes.

The plugin server runs with the daemon. Install it only after reviewing the source and treating it as trusted, unsandboxed local code.

Installation

Install the source from GitHub into the selected Paseo daemon:

paseo plugin install github:fxbing/paseo-workboard

For local development or evaluation, install a checkout into the selected Paseo daemon:

npm ci
paseo plugin install /absolute/path/to/paseo-workboard

Enable plugins in Paseo, then open Workboard from the sidebar.

Quick start

1. Open Workboard. Existing active workspaces appear as tasks. Workspaces without a managed status label enter Inbox without writing a label during import.
2. Create a draft with a title when you have an idea. It stays in To do and has no workspace yet.
3. Select Start work to create a workspace or attach an existing one. Start a conversation from the native workspace when needed.
4. Move a card between groups with the status menu or, on desktop, its drag handle. Managed labels and task status stay synchronized.
5. Configure labels, groups, automatic archiving, and optional sidebar pinning in Settings.

Documentation

• User guide: task flow, groups, board interaction, archive, pinning, and local preferences.
• 中文使用指南: the same guide in Chinese.
• Contributing · 中文贡献指南
• Architecture · 中文架构
• Releasing · 中文发布
• Verification · 中文验证

Development

npm ci
npm run format:check
npm run check
npm run check:package
npm pack --dry-run

Use the isolated integration fixture for host-level checks. Do not load development builds into a personal daemon as a substitute for that fixture.

Limitations

• Workboard targets Paseo 0.9.1 exactly. Its internal bridge for label and workspace writes can require changes for later Paseo versions.
• Automatic archival can stop Agents and terminals and may remove a managed worktree. Incomplete conversation history postpones automatic archival; Workboard cannot restore a native archive or a removed worktree.
• Native workspace labels, archive, and sidebar pins can change outside Workboard. The host does not expose every atomic operation, so uncertain operations are retained for manual review rather than retried destructively.
• The native mobile clients are not verified.

License and acknowledgements

MIT.

The project was inspired by Paseo Thread Board and Paseo Kanban.