Skip to content
Back to search

heptabase-cli-skills

Agent skills for Heptabase CLI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/heptameta--heptabase-cli-skills/badge.svg)](/listings/heptameta--heptabase-cli-skills)

HTML

<a href="/listings/heptameta--heptabase-cli-skills"><img src="/api/listings/heptameta--heptabase-cli-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (Marketplace)

/plugin marketplace add heptameta/heptabase-cli-skills
/plugin install heptabase@heptabase-cli-skills

npx skills

npx skills add git@github.com:heptameta/heptabase-cli-skills.git

Claude Code

Add the contents of this repo to a `.claude` folder in the root of the project you're using with Claude Code. See more in the [official Claude Skills documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).

Codex CLI

Copy the contents of `skills/` into your user skills path (prefer `~/.agents/skills/`; `~/.codex/skills/` still works). For example:

mkdir -p ~/.agents/skills
cp -R skills/heptabase-cli ~/.agents/skills/heptabase-cli

See the [Agent Skills specification](https://agentskills.io/specification) for the standard skill format.

Codex sandbox note: if Heptabase starts but Codex says the CLI server is not ready, see [Codex sandbox troubleshooting](skills/heptabase-cli/references/codex-sandbox.md).

OpenCode

Clone the entire repo into the OpenCode skills directory (`~/.opencode/skills/`):

git clone https://github.com/heptameta/heptabase-cli-skills.git ~/.opencode/skills/heptabase-cli-skills

Do not copy only the inner `skills/` folder. Clone the full repo so the directory structure is `~/.opencode/skills/heptabase-cli-skills/skills/<skill>/SKILL.md`.

OpenCode auto-discovers all `SKILL.md` files under `~/.opencode/skills/`. No changes to `opencode.json` or any config file are needed. Skills become available after restarting OpenCode.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "heptabase-cli-skills",
  3. "owner": {
  4. "name": "Heptabase"
  5. },
  6. "metadata": {
  7. "description": "Skills for Heptabase CLI"
  8. },
  9. "plugins": [
  10. {
  11. "name": "heptabase",
  12. "source": "./",
  13. "description": "Skills for Heptabase CLI"
  14. }
  15. ]
  16. }
README.md · README · 84 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. Agent Skills for use with [Heptabase](https://heptabase.com/).
  2. These skills follow the [Agent Skills specification](https://agentskills.io/specification) so they can be used by any skills-compatible agent, including Claude Code and Codex CLI.
  3. ## Installation
  4. ### Claude Code (Marketplace)
  5. ```
  6. /plugin marketplace add heptameta/heptabase-cli-skills
  7. /plugin install heptabase@heptabase-cli-skills
  8. ```
  9. ### npx skills
  10. ```
  11. npx skills add git@github.com:heptameta/heptabase-cli-skills.git
  12. ```
  13. ### Claude Code
  14. Add the contents of this repo to a `.claude` folder in the root of the project you're using with Claude Code. See more in the [official Claude Skills documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).
  15. ### Codex CLI
  16. Copy the contents of `skills/` into your user skills path (prefer `~/.agents/skills/`; `~/.codex/skills/` still works). For example:
  17. ```
  18. mkdir -p ~/.agents/skills
  19. cp -R skills/heptabase-cli ~/.agents/skills/heptabase-cli
  20. ```
  21. See the [Agent Skills specification](https://agentskills.io/specification) for the standard skill format.
  22. Codex sandbox note: if the desktop app is open with the CLI on but `heptabase` commands still cannot connect, the sandbox is blocking localhost. Retry outside the sandbox, or add `network_access = true` under `[sandbox_workspace_write]` in `~/.codex/config.toml` and restart Codex.
  23. ### OpenCode
  24. Clone the entire repo into the OpenCode skills directory (`~/.opencode/skills/`):
  25. ```
  26. git clone https://github.com/heptameta/heptabase-cli-skills.git ~/.opencode/skills/heptabase-cli-skills
  27. ```
  28. Do not copy only the inner `skills/` folder. Clone the full repo so the directory structure is `~/.opencode/skills/heptabase-cli-skills/skills/<skill>/SKILL.md`.
  29. OpenCode auto-discovers all `SKILL.md` files under `~/.opencode/skills/`. No changes to `opencode.json` or any config file are needed. Skills become available after restarting OpenCode.
  30. ## Update
  31. The skill declares the oldest CLI it needs in its frontmatter (`heptabase-cli-version-range`) and leaves command details to the System Manual that ships with each CLI, so updating the desktop app does not require a skill update. Update this package to pick up new skill releases.
  32. For Claude Code marketplace installs, refresh the marketplace, update the plugin, then reload plugins:
  33. ```
  34. /plugin marketplace update heptabase-cli-skills
  35. /plugin update heptabase@heptabase-cli-skills
  36. /reload-plugins
  37. ```
  38. For `npx skills` installs, rerun:
  39. ```
  40. npx skills add git@github.com:heptameta/heptabase-cli-skills.git
  41. ```
  42. For OpenCode installs, pull the latest repo:
  43. ```
  44. git -C ~/.opencode/skills/heptabase-cli-skills pull
  45. ```
  46. For Codex installs, replace the copied skill folder from this repo:
  47. ```
  48. cp -R skills/heptabase-cli ~/.agents/skills/heptabase-cli
  49. ```
  50. ## Skills
  51. <!-- prettier-ignore -->
  52. | Skill | Description |
  53. |---|---|
  54. | [heptabase-cli](skills/heptabase-cli) | Use Heptabase CLI for search, notes, journals, Space Instructions, the Inbox, tags, cards, files, whiteboard structure and layout, mind-map work, schematic screenshots, goals, courses, and lessons. Points agents to the CLI's own System Manual |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.