Releases: DCPRevere/org-cli
Release list
org-cli v2.0.0
Stable release of the standalone Org engine and shared human/agent task workflow. Reissued on 2026-09-17 with opt-in systemd user service installation and the updated browser UI. GitHub downloads replace the original 2.0.0 build; AUR uses package revision 3 (2.0.0-3). NuGet.org cannot replace a published version, so its 2.0.0 package remains the original build; use GitHub binaries or AUR for the updated build.
-
Add remembered System/Light/Dark themes and remove the header tagline.
-
Add Board, Agenda and month/week Calendar views with shared filters, source files, ownership, planning dates, tags and workflow warnings. Calendar shows recorded occurrences; future repeats are not expanded.
-
Load the workspace automatically, prompt for a token only when required, and remember the explicitly entered name for task history.
-
Make cancellation reasons optional across CLI, HTTP, MCP and the UI; show cancellation progress and completion.
-
Queue navigation during refreshes, show loading activity, prevent duplicate writes while busy, and report request failures/timeouts. Browser regressions cover delayed cancellation and subsequent actions without external file edits.
-
Anchor HTTP host configuration discovery to the executable directory, avoiding accidental scans of the user’s home when started by systemd.
-
Add opt-in
org service install|status|restart|stop|uninstallfor Linux systemd user services, with external workspace settings, readiness checks and preservation of custom units. -
Ship a user service unit in the AUR package and Linux release archives; standalone binaries embed the same template. Package installation never starts a server or enables lingering.
-
Org files are authoritative; the disposable search index refreshes through content checks and a server filesystem watcher. Direct editor changes are supported.
-
One binary provides the CLI, browser task board, optional HTTP API and MCP. Org-roam is an optional extension.
-
Tasks support dependencies, assignment, expiring claims, handoffs, evidence submission, review and recovery from externally edited requirements. The board refreshes automatically without replacing unsaved drafts.
-
Includes search/cache performance fixes, consistent overdue agendas, and corrected empty-property parsing.
-
Correct package descriptions to describe standalone Org/task management rather than Emacs database synchronization.
Upgrading from 1.x
Keep your Org files and IDs. Use a CLI-owned .org-index.db, never an Emacs org-roam.db; the index is rebuilt automatically. Consumers should use standard id values and explicit pos: selectors. OpenClaw plugins and skills are retired; use the CLI, API or MCP instead.
Start the task board with org serve -d ~/org --mcp. See the task workflow guide and architecture/migration guide.
Validation: 878 automated tests passed, with 8 legacy Emacs tests skipped; browser and real-process API/MCP, watcher and competing-worker checks passed. Native macOS and Windows smoke tests passed during development; routine CI runs on Linux. Actor names are cooperative attribution, not authenticated approval identities; task leases coordinate one local filesystem, not independent synced replicas.
Arch Linux: upgrade to org-cli-bin 2.0.0-3, then run org service restart and refresh the browser.
org-cli v2.0.0-rc.2
Shared task management for humans and agents, with Org files authoritative across the CLI, browser board, API, MCP, and direct editor changes.
-
Recover stale task workflows with an audited reset, respect manually reopened cancellations, and automatically refresh the board without overwriting drafts.
-
Keep routine CI Linux-only; native macOS and Windows smoke tests were verified during development.
-
Detect direct requirement edits during claims and review; block stale completion evidence, preserve claims across refiling, and show actionable recovery in the board.
-
Add a shared human/agent task workflow: dependency-aware ready queues, project/owner assignment, expiring claims, handoffs, evidence-backed submission, and separate-actor review. Existing Org TODOs can be adopted without migration.
-
Add
org taskcommands, four task API/MCP operations, and a browser task board embedded in the same executable. -
Fix repeated directory traversal in CLI full-text search; avoid redundant timestamp writes and configuration formatting during cache refresh.
-
Unify overdue scheduled work and file-local completion handling across CLI and API agendas.
-
Fix empty Org properties/keywords consuming the following line, and rebuild older cached projections automatically.
-
HTTP and stdio MCP servers now watch the workspace for external edits, update only affected projections, and reuse cached snapshots between changes. Startup, directory changes, watcher errors, and periodic reconciliation repair missed notifications.
-
Add virtual-filesystem tests and live watcher tests for atomic saves, renames, and deletion.
Validation: 868 automated tests passed (8 legacy Emacs tests skipped), plus browser, API/MCP, filesystem watcher and competing-worker checks. Native macOS and Windows smoke tests passed during development; routine CI runs on Linux.
Start the browser board and optional MCP endpoint with org serve -d ~/org --mcp. Ordinary CLI commands still work without a server. See the task workflow guide.
This is a prerelease. Actor names are cooperative attribution, not authenticated review identities; leases coordinate one local filesystem, not independent synced replicas.
v2.0.0-rc.1
Changelog
2.0.0-rc.1
First release candidate for the standalone Org engine and optional API/MCP interfaces. Try it against a copy of your Org workspace before adopting it for daily use.
Added
- One executable with optional
org serve,org serve --mcp, andorg mcp --stdiomodes. Ordinary CLI commands still run and exit without a server. - Search, fetch, agenda, capture, append, task updates, and backlinks through a shared workspace API, exposed over HTTP and MCP.
- Revision checks for API updates, persistent capture deduplication, read-only mode, optional bearer authentication, and a loopback-only HTTP listener.
- An injectable filesystem, environment, and clock with virtual-workspace tests and real-process HTTP/MCP smoke coverage.
- Recovery journals and
org recoverfor interrupted multi-file changes.
Changed — migration required
- Org files are authoritative. The CLI owns a rebuildable
.org-index.dbwith parsed document snapshots, full-text search, and identity lookup. Queries refresh it automatically using content and parser-configuration fingerprints. - Org-roam is an optional extension over Org documents. The CLI no longer reads or writes Emacs's org-roam database. Emacs should index the shared files independently.
org addalways assigns a standard UUIDID. Consumers should prefer JSONid; existingcustom_idvalues and legacy short-ID helpers remain supported.- Explicit character offsets now use
pos:<offset>. Numeric text is no longer treated as a position; duplicate identities and ambiguous matches fail instead of silently selecting an entry. - File-level notes support core search, read, append, and backlinks without org-roam.
Fixed
- Changes with unchanged timestamps now invalidate cached projections; querying a subdirectory retains unrelated cached documents.
- Failed batch validation writes no source files. Refile and archive validate destinations and stage outputs before replacement.
- Conflicting writes, unfinished recovery operations, and recovery conflicts are detected. Source-block headline examples are preserved during subtree moves.
Removed
- Retired the OpenClaw
org-cliandorg-memoryplugins, skills, tests, npm packaging, and ClawHub publishing. Previously published packages remain available but are no longer updated by this repository.
Upgrade
- Keep existing Org files and IDs; no content conversion is required.
- Point the CLI at a CLI-owned
.org-index.db, not an Emacsorg-roam.dbor a previously shared database. The first query builds the new index. - Update consumers to use standard
idvalues and explicitpos:selectors where applicable. - Use the CLI, the optional HTTP API, or MCP in place of the retired OpenClaw integration.
See architecture and migration and API/MCP usage.
RC validation and limits
- The .NET suite passes 838 tests, including virtual workspace and HTTP/MCP coverage. Eight legacy Emacs database interoperability tests are skipped; they do not validate the new extension.
- Linux CLI, NuGet installation, single-file publishing, HTTP, and stdio MCP smoke tests pass. macOS, Windows, and ARM artifacts are cross-built; native execution on those platforms is not yet verified. A direct ChatGPT account connection has not been tested.
- Cache freshness still reads the selected corpus. Multi-file writes are recoverable, not an OS-level atomic transaction; unrelated editors do not participate in CLI locks, and directory metadata is not explicitly fsynced.
- HTTP is a local bridge. OAuth and public multi-user hosting are not included.
Security
- Update the bundled SQLite dependency to SQLitePCLRaw 2.1.13, addressing CVE-2025-6965.
v1.0.2
v1.0.1
v1.0.0
org-cli v1.0.0 Split the monolithic org-memory plugin into two: - @dcprevere/org-cli: user-facing task and knowledge management - @dcprevere/org-memory: agent-memory extension, overrides memory-wiki Breaking change: env var names renamed, k: shortcut now targets the user's roam by default, tools lost the dir: "human" | "agent" parameter. See each plugin's README for the migration table.