Not in the top 1,000 by GitHub stars
heptameta/heptabase-cli-skills
Agent skills for Heptabase CLI.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/heptabase-cli/SKILL.md
Week of Nov 2, 2026 · +32 / −19 lines
Before Not checked yet → After Network or broad shell
c5b1ff715bf4 → eee593904a11
Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Not checked yet
First observation → c5b1ff715bf4
No earlier version was observed for comparison.
View on GitHubAdd to my skills
Verified commit eee593904a11f489cf7c64c7bef115ff24aca8fe
git clone --filter=blob:none --no-checkout https://github.com/heptameta/heptabase-cli-skills.git .hotskills/heptameta-heptabase-cli-skills && git -C .hotskills/heptameta-heptabase-cli-skills checkout --detach eee593904a11f489cf7c64c7bef115ff24aca8fe
# Copy each selected skill directory from .hotskills/heptameta-heptabase-cli-skills into .claude/skills/<skill-name>/git clone --filter=blob:none --no-checkout https://github.com/heptameta/heptabase-cli-skills.git .hotskills/heptameta-heptabase-cli-skills && git -C .hotskills/heptameta-heptabase-cli-skills checkout --detach eee593904a11f489cf7c64c7bef115ff24aca8fe
# Copy each selected skill directory from .hotskills/heptameta-heptabase-cli-skills into .agents/skills/<skill-name>/158GitHub stars
1star in 7 days
1skill in this repository
4commits in 30 days
Heat
2.8- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
- heptabase-cli
skills/heptabase-cli
How it works
heptabase-cli
When your agent uses it
Use the local heptabase CLI whenever the user mentions Heptabase or shares an app.heptabase.com URL/deep link. Read and edit notes, journals, and properties; list, query, create, and edit tags and tag databases; read chats, messages, files, highlights, and backlinks; import local files and URLs, save PDF, image, audio, video, YouTube, and web page cards, and parse PDFs; and work with whiteboard structure and layout through the running desktop app, including sections, connections, mind maps, lint, and schematic screenshots. Also browse AI Tutor goals, courses, and lessons. Do not open Heptabase links in an agent browser unless the user asks.
What it loads into context
Frontmatter
187 tokensAlways available to the agent
SKILL.md
3,817 tokensWhen the skill is activated
Reference documents
21,848 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Prerequisites
- Command discovery
- Common recipes
- Heptabase URLs (Deep links)
- Note and journal card content editing
- Created by AI marking
- Property editing
- Tags and tag databases
- File reading
- Importing files and URLs
- PDF reading
- Transcript reading
- Whiteboard work
- Canonical JSON input
- All output is JSON
- Troubleshooting
- Known limitations
- Warnings
Files
../../.claude-plugin/marketplace.jsonasset275 bytes../../.claude-plugin/plugin.jsonasset529 bytesSKILL.mdcore15,979 bytesSKILL.mdcore15,979 bytesSKILL.mdcore15,979 bytesSKILL.mdcore15,979 bytesSKILL.mdcore15,979 bytesreferences/card-content-schema.mddoc20,069 bytesreferences/codex-sandbox.mddoc790 bytesreferences/created-by-ai.mddoc2,148 bytesreferences/file-reading.mddoc5,766 bytesreferences/importing.mddoc12,849 bytesreferences/mind-maps.mddoc7,426 bytesreferences/pdf-reading.mddoc3,276 bytesreferences/property-values.mddoc4,339 bytesreferences/tag-databases.mddoc11,228 bytesreferences/transcript-reading.mddoc2,190 bytesreferences/whiteboard.mddoc11,341 bytes
Read SKILL.md
## Prerequisites
- CLI installed from the desktop app. The command is `heptabase` on macOS/Linux; Windows installs `heptabase.cmd` for cmd/PowerShell and a `heptabase` shim for POSIX shells.
- Check version compatibility before use with `heptabase --version`. If the installed CLI version is outside this skill's compatibility range (`0.9.x`), you MUST stop and ask the user to update either the Heptabase desktop app or this skill package before continuing.
## Command discovery
Run `heptabase help` to see all available top-level commands. This is always up to date. Each command supports `--help` for detailed usage:
```bash
heptabase help
heptabase note --help
heptabase note create --help
```Skills included
- heptabase-cli
Repository facts
- License
- MIT
- Created
- Apr 27, 2026
- Last pushed
- Nov 3, 2026
- Forks
- 12
- Open issues
- 2
- Project activity
- Active
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 6, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 4 notes
skills/heptabase-cli/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/heptabase-cli/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/heptabase-cli/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/heptabase-cli/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 20 network referencesin 5 files: heptabase-cli/references/importing.md:16 heptabase-cli/references/card-content-schema.md:71 .claude-plugin/plugin.json:6 and 2 more
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- No access to secrets
- No requests to vote in Hot
Show all 20 signals by file
.claude-plugin/plugin.json
- Network accessline 6
"name": "Heptabase" }, "repository": "https://github.com/heptameta/heptabase-cli-skills", - Network accessline 7
}, "repository": "https://github.com/heptameta/heptabase-cli-skills", "license": "MIT", - Network accessline 8
"repository": "https://github.com/heptameta/heptabase-cli-skills",
skills/heptabase-cli/SKILL.md
- Network accessline 56
- **Journal card:** `https://app.heptabase.com/<workspaceId>/card/<YYYY-MM-DD>` → `heptabase journal read <YYYY-MM-DD>` - Network accessline 57
- **Card by UUID:** `https://app.heptabase.com/<workspaceId>/card/<uuid>` → first run `heptabase card properties <uuid>` to discover the card type, then read its content with the matching command (`heptabase note read <uuid>`, `heptabase pd - Network accessline 58
- **Whiteboard:** `https://app.heptabase.com/<workspaceId>/whiteboard/<uuid>` → run `heptabase whiteboard read <uuid> --mode structure` and `heptabase whiteboard read-layout <uuid>`. Read `references/whiteboard.md` before any layout mutatio
skills/heptabase-cli/references/card-content-schema.md
- Network accessline 71
<hepta-video src="https://www.youtube.com/watch?v=example"></hepta-video> - Network accessline 231
{ "type": "link", "attrs": { "href": "https://heptabase.com" } - Network accessline 232
"type": "link", "attrs": { "href": "https://heptabase.com" } } - Network accessline 233
"attrs": { "href": "https://heptabase.com" }
skills/heptabase-cli/references/importing.md
- Network accessline 16
Use `file import --url` only when the URL serves the file itself, for example `https://arxiv.org/pdf/<arxivId>` or a link ending in `.pdf`. A web page imported with `file import --url` becomes a `fileKind: "file"` that no card can be made f - Network accessline 27
- `<path>` is a local file. Relative paths are resolved from the current directory. The CLI reads the file itself, so your own file permissions apply; an `EACCES` or `EPERM` error comes from your environment, not from Heptabase. - `-` reads - Network accessline 28
- `-` reads the file from stdin. `--name` is then required, for example `--name diagram.png`. - `--url` downloads an `http` or `https` URL with your own network access, as `curl` would, so local and private addresses work too. Without `--na - Network accessline 29
- `--url` downloads an `http` or `https` URL with your own network access, as `curl` would, so local and private addresses work too. Without `--name`, the file is named from the server's `Content-Disposition` header or the last part of the - Network accessline 123
"status": "created", "webCardId": "55555555-5555-4555-8555-555555555555", "title": "https://example.com/article" - Network accessline 124
"webCardId": "55555555-5555-4555-8555-555555555555", "title": "https://example.com/article" } - Network accessline 125
"title": "https://example.com/article"
skills/heptabase-cli/references/property-values.md
- Network accessline 54
| `date` | JSON object via `--json-value '{"start":"2026-05-05T00:00:00.000Z"}'`. The CLI normalizes `start` to an ISO UTC string with milliseconds and stores `end: null` because the UI does not display date ranges. | | `checkbox` | Boolean - Network accessline 55
| `checkbox` | Boolean via `--json-value true` or `--json-value false`. | | `url` | Literal string via `--value "https://example.com"`. | | `phone` | Literal string via `--value "+1 555 123 4567"`. | - Network accessline 56
| `url` | Literal string via `--value "https://example.com"`. |
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Signal confidence: 17 facts
- Network access in prose of the SKILL.mdheptabase-cli/SKILL.md:56Low confidence
- Network access in prose of the SKILL.mdheptabase-cli/SKILL.md:57Low confidence
- Network access in prose of the SKILL.mdheptabase-cli/SKILL.md:58Low confidence
- Network access in code of documentationheptabase-cli/references/card-content-schema.md:71Low confidence
- Network access in code of documentationheptabase-cli/references/card-content-schema.md:231Low confidence
- Network access in code of documentationheptabase-cli/references/card-content-schema.md:232Low confidence
- Network access in code of documentationheptabase-cli/references/card-content-schema.md:233Low confidence
- Network access in prose of documentationheptabase-cli/references/importing.md:16Low confidence
- Network access in prose of documentationheptabase-cli/references/importing.md:27Low confidence
- Network access in prose of documentationheptabase-cli/references/importing.md:28Low confidence
- Network access in prose of documentationheptabase-cli/references/importing.md:29Low confidence
- Network access in code of documentationheptabase-cli/references/importing.md:123Low confidence
- Network access in code of documentationheptabase-cli/references/importing.md:124Low confidence
- Network access in code of documentationheptabase-cli/references/importing.md:125Low confidence
- Network access in prose of documentationheptabase-cli/references/property-values.md:54Low confidence
- Network access in prose of documentationheptabase-cli/references/property-values.md:55Low confidence
- Network access in prose of documentationheptabase-cli/references/property-values.md:56Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Native | Manifest .claude-plugin/marketplace.json | .claude/skills/<skill-name>/ |
| Codex | Native | Manifest AGENTS.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/heptabase-cli/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/heptabase-cli/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/heptabase-cli/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/heptabase-cli/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
