← Back to Skills Marketplace
108
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install org-cli
Description
Task capture, scheduling, and linked knowledge in org-mode files via the `org` CLI. Query, mutate, link, and search the user's org files and org-roam database.
Usage Guidance
This skill will read and write files in whatever directories you point it at (ORG_CLI_DIR, ORG_CLI_ROAM_DIR) and operate against the specified SQLite DB (ORG_CLI_DB). Before installing, confirm those env vars point to the correct org workspace and that the `org` binary you intend to use is trusted. Be aware the plugin injects shortcut handling so quick-capture prefixes (t:, n:, k:, d:, s:, f:) can trigger writes — if you want an extra safety gate, avoid enabling autonomous invocation or set the workspace paths to a non-sensitive test folder first. Note also that the plugin executes the local `org` binary via execFile (not a shell), which reduces shell-injection risk, but the plugin will still perform arbitrary mutations to files it has access to, so check file permissions and backups if you are concerned about unintended changes.
Capability Analysis
Type: OpenClaw Skill
Name: org-cli
Version: 1.0.2
The org-cli skill bundle provides a legitimate interface for managing Org-mode files and knowledge bases via an external CLI binary. The implementation in `plugin/lib.ts` uses `execFile` for command execution, which is a secure practice, and the `SKILL.md` documentation includes explicit 'Command safety' instructions to prevent shell injection when handling user-provided text. No evidence of data exfiltration, unauthorized persistence, or malicious intent was found across the code or agent instructions.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: it runs a local `org` binary and reads/writes the user's org workspace, roam dir, and SQLite DB. Required env vars (ORG_CLI_DIR, ORG_CLI_ROAM_DIR, ORG_CLI_DB, ORG_CLI_BIN, ORG_CLI_INBOX_FILE) are appropriate for this purpose and no unrelated credentials or services are requested.
Instruction Scope
SKILL.md and plugin code limit operations to the declared workspace, roam directory, and DB. Instructions describe searching, creating, and mutating headlines/nodes and explicitly require surfacing IDs and printing write confirmations. The plugin injects shortcut-handling instructions into agent context (expected for a capture tool). There are no instructions to read or transmit unrelated system data or to contact external endpoints.
Install Mechanism
No external install/download spec is included; the package is source-only with a small npm dependency. No arbitrary remote archives or URL downloads are part of the install spec, so installation risk is low.
Credentials
Requested environment variables are non-secret configuration (paths and binary name) and are proportional to the skill's actions. The plugin does not request API keys, tokens, or other unrelated secrets.
Persistence & Privilege
always is false and the plugin registers hooks/tools normally; it prepends instruction context at session start and registers tools that can write to the declared org files/DB. This is expected for a capture/agent-facing plugin. It does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install org-cli - After installation, invoke the skill by name or use
/org-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
org-cli 1.0.2
- Added new environment variables to requirements: ORG_CLI_ROAM_DIR, ORG_CLI_DB, ORG_CLI_BIN, ORG_CLI_INBOX_FILE.
- Updated documentation to reflect new environment requirements and improved variable coverage.
- Version bumped from 1.0.0 to 1.0.2 across the project.
- No functional behavior changes; metadata and documentation improvements only.
v1.0.1
- Updated dependencies in package.json and package-lock.json for improved stability.
- Internal updates to plugin/index.ts.
- Plugin metadata in openclaw.plugin.json refreshed.
- No changes to user-facing features or documentation.
v1.0.0
org-cli 1.0.0 – Initial release
- Adds commands for capturing tasks, scheduling, and linked knowledge in org-mode files via the `org` CLI.
- Supports quick-action prefixes: `n:` (note), `k:` (knowledge), `f:` (find), `t:` (TODO), `s:` (schedule), `d:` (done).
- Enforces surface of stable IDs with every org item mentioned; every mutation and search surfaces an ID.
- Details strict handling of writes—no silent or context-only updates; all changes are confirmed with output.
- Integrates with org-roam for structured personal knowledge management and search.
- Users can act and reference items by their surfaced IDs for all workflow operations.
Metadata
Frequently Asked Questions
What is org-cli?
Task capture, scheduling, and linked knowledge in org-mode files via the `org` CLI. Query, mutate, link, and search the user's org files and org-roam database. It is an AI Agent Skill for Claude Code / OpenClaw, with 108 downloads so far.
How do I install org-cli?
Run "/install org-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is org-cli free?
Yes, org-cli is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does org-cli support?
org-cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created org-cli?
It is built and maintained by DCPRevere (@dcprevere); the current version is v1.0.2.
More Skills