AgentBoard

Rust CLI for collecting task-tracking items from many sources into a local store, then running workspace-configured actions.

Purpose

AgentBoard is an automation bridge for agent work queues. It queries sources such as QMD-backed markdown, copies items locally, then runs rules from a TOML workspace file.

Query sources -> Store locally -> Run actions

Workspace config

Workspace files live in user config:

~/.config/agentboard/
  work.toml
  personal.toml

Example:

[[sources]]
id = "foo"

[sources.source]
kind = "qmd"
collections = ["tasks"]
query = "intent: Find ready agent work\nlex: status ready"

[[sources.actions]]
uses = "agentboard/create-worktree"

[sources.actions.with]
repo = "~/Projects/MyProject"
root = "~/Projects/MyProject.worktrees/{{ item.id }}"
branch = "{{ item.id }}/{{ item.title | slugify }}"

[[sources.actions]]
uses = "agentboard/run-cmd"

[sources.actions.with]
cmd = "zellij action new-tab --name {{ item.id }}"

Jira Cloud source example:

[[sources]]
id = "jira"

[sources.source]
kind = "jira"
site = "https://your-domain.atlassian.net"
email_env = "JIRA_EMAIL"
token_env = "JIRA_API_TOKEN"
jql = "project = AB AND statusCategory != Done ORDER BY updated DESC"
limit = 50

[sources.source.field_map]
id = "key"
title = "fields.summary"
status = "fields.status.name"
url = "fields.customfield_10010"

GitHub issue source example:

[[sources]]
id = "github"

[sources.source]
kind = "github"
mode = "issue"
query = "repo:zenobi-us/agentboard is:open label:ready"
limit = 50
status_map = { ready = "ready" }

[sources.source.credentials]
helper = "gh auth token"

Projects

• apps/cli — Rust CLI crate.
• pkgs/crates/agentboard-core — shared model/types.
• pkgs/crates/agentboard-source-* — one crate per source adapter.
• pkgs/crates/agentboard-action-* — one crate per action executor.
• apps/docs — docs app.
• pkgs/tools/deployment — release/deploy helpers.

Setup

proto install
bun install
moon query projects

Common tasks

moon run agentboard:build
moon run agentboard:test
moon run docs:dev