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.
Badge for your README
Markdown
[](/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
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.
- {
- "name": "heptabase-cli-skills",
- "owner": {
- "name": "Heptabase"
- },
- "metadata": {
- "description": "Skills for Heptabase CLI"
- },
- "plugins": [
- {
- "name": "heptabase",
- "source": "./",
- "description": "Skills for Heptabase CLI"
- }
- ]
- }
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.
- Agent Skills for use with [Heptabase](https://heptabase.com/).
- 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.
- ## Installation
- ### 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 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.
- ### 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.
- ## Update
- 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.
- For Claude Code marketplace installs, refresh the marketplace, update the plugin, then reload plugins:
- ```
- /plugin marketplace update heptabase-cli-skills
- /plugin update heptabase@heptabase-cli-skills
- /reload-plugins
- ```
- For `npx skills` installs, rerun:
- ```
- npx skills add git@github.com:heptameta/heptabase-cli-skills.git
- ```
- For OpenCode installs, pull the latest repo:
- ```
- git -C ~/.opencode/skills/heptabase-cli-skills pull
- ```
- For Codex installs, replace the copied skill folder from this repo:
- ```
- cp -R skills/heptabase-cli ~/.agents/skills/heptabase-cli
- ```
- ## Skills
- <!-- prettier-ignore -->
- | Skill | Description |
- |---|---|
- | [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 inFree to use. If it’s helped, pass it on.