Skip to content

Releases: DCPRevere/org-cli

org-cli v2.0.0

Choose a tag to compare

@github-actions github-actions released this 17 Sep 08:03

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|uninstall for 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

org-cli v2.0.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Sep 07:25

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 task commands, 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

v2.0.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Sep 21:09

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, and org mcp --stdio modes. 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 recover for interrupted multi-file changes.

Changed — migration required

  • Org files are authoritative. The CLI owns a rebuildable .org-index.db with 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 add always assigns a standard UUID ID. Consumers should prefer JSON id; existing custom_id values 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-cli and org-memory plugins, skills, tests, npm packaging, and ClawHub publishing. Previously published packages remain available but are no longer updated by this repository.

Upgrade

  1. Keep existing Org files and IDs; no content conversion is required.
  2. Point the CLI at a CLI-owned .org-index.db, not an Emacs org-roam.db or a previously shared database. The first query builds the new index.
  3. Update consumers to use standard id values and explicit pos: selectors where applicable.
  4. 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

Choose a tag to compare

@github-actions github-actions released this 22 Apr 09:01
chore: bump version to 1.0.2

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 21 Apr 21:10
chore: bump version to 1.0.1

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 18 Apr 13:55
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.

v0.6.1

Choose a tag to compare

@github-actions github-actions released this 24 Mar 09:21
chore: bump version to 0.6.1

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 23 Mar 16:32
chore: bump version to 0.6.0

v0.5.3

Choose a tag to compare

@github-actions github-actions released this 13 Mar 15:26
chore: bump version to 0.5.3

v0.5.2

Choose a tag to compare

@github-actions github-actions released this 13 Mar 14:24
chore: bump version to 0.5.2