Releases: mazen160/backlog
Releases · mazen160/backlog
v1.0.1
Bug Fixes
- Task search: bare integers (
42) andTASK-Nreferences now do a direct seq lookup instead of going through FTS5 - CLI output:
task addnow correctly populates the Project field in table output (was showing empty) - Board view: fixed cap at 50 tasks — board now fetches all tasks regardless of total count
- Sort direction:
order=asc/descis now respected in both list and board views - Activity feed: task detail activity now shows the correct actor instead of
undefined:undefined - Attachment delete: clicking Delete in task detail now shows a confirmation dialog before deleting
- Attachment download: Download button in task detail no longer returns 404
- Attachment activity: task detail activity feed now correctly filters to the current task
New Features
project addalias-only:backlog project add --alias myprojectworks without a positional name argument; name defaults to the alias- Attachments API:
GET /api/attachments?task_id=<id>returns attachments for a specific task - Attachment preview: clicking a filename in the task detail Attachments section opens a preview modal for images; other file types open in a new tab
- Skills: added
backlog-memory,backlog-memory-learn, andbacklog-memory-storeskills for agentic memory workflows
v1.0.0
A local-first task queue your AI coding agents can read and write directly.
Single binary, no server, no SaaS.
Workspace
backlog initcreatesbacklog.db(SQLite, WAL mode) andconfig.toml.- Profiles registered in
~/.config/backlog/config.toml; switch with--profile. - DB resolution chain:
--db→$BACKLOG_DB→--profile→ default profile. backlog doctor checkrunsPRAGMA integrity_check;doctor backupdoes an atomicVACUUM INTO.
Tasks, plans, comments
backlog task add/list/show/update/move/archive/deletewith human-readableTASK-Nrefs, full ULIDs, or bare integers.- Types
task/bug/issue/improvement/feature/vulnerability/chore/spike/bucket-list; statusestodo/doing/done; priorities P1–P5. - FTS5 full-text search across title and description with prefix (
sql*) and boolean (jwt OR csrf) support. - Plans are versioned markdown: every edit creates a new immutable version, full history queryable via
plan history. - Comments are append-only and actor-attributed.
Project knowledge
backlog memory add/list/append— tagged free-form notes for cross-session agent scratchpads.backlog doc add/list/show/update/history— versioned project documentation.backlog attachment add/list/fetch/delete— binary files stored inside the SQLite DB.backlog label create/list/attach/detach— per-project tags with optional hex color.
Actor attribution
- Every write takes
--as kind:name(e.g.ai:claude-code,human:alice). - Actor stored as a
(kind, name)pair at the DB level with aCHECKconstraint, exposed on every row in the activity log. - Defaults to
human:$USERwhen--asis omitted.
Import / export
backlog import-findings <file.json>bulk-creates tasks from structured findings (security scanners, AI triage agents); supports inline plans per item;--dry-runavailable.backlog import <other.db>copies tasks, plans, comments, and labels from another workspace.backlog export --format json|csv|mdwith optional--projectand--outflags.
Surfaces
- CLI — every command supports
--jsonfor machine-readable output. - HTTP API —
backlog webstarts an embedded server with a Notion-style SPA (tasks, board, grid, plans, docs, memory, attachments, activity). - MCP server —
backlog mcp serveexposes the operations as JSON-RPC 2.0 tools over stdio. Compatible with Claude Code, Cursor, Codex, and OpenCode. - Skills — four agentic-loop skills (
backlog,backlog-enhance-tasks,backlog-loop,backlog-goal) embedded in the binary.backlog install-skillswrites them into~/.claude,~/.cursor,~/.config/opencode, and~/.codexin each tool's native format.
Developer experience
backlog completion bash|zsh|fish|powershell— shell completion scripts.backlog activity— append-only audit trail of every state transition.backlog schema— JSON Schema fortask,findings_file,manifest, andactorpayloads.backlog version— version injected via ldflags at build time.