Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Mininglamp-OSS/octo-cli --skill octo-sharedgit clone --depth 1 https://github.com/Mininglamp-OSS/octo-cliWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/mininglamp-oss/octo-cli/octo-shared)<a href="https://agentmods.dev/skills/mininglamp-oss/octo-cli/octo-shared"><img src="https://agentmods.dev/badge/skills/mininglamp-oss/octo-cli/octo-shared/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/mininglamp-oss/octo-cli/octo-shared"><img src="https://agentmods.dev/badge/skills/mininglamp-oss/octo-cli/octo-shared.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00042 | $0.04278 |
| Opus 5.5 | $0.00017 | $0.01711 |
| Sonnet 5.5 | $0.00008 | $0.00856 |
| Haiku 4.5 | $0.00004 | $0.00428 |
Grade A, and why
octo-shared scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 310 lines — stays where its author put it; the contents beside it link to each section on GitHub.
octo-shared — CLI fundamentals for AI Agents
octo-cli exposes the Octo ecosystem through active service commands, including messaging, groups, threads, files, bot, events, Drive, docs, HTML, Marketplace and Loop. Every service command is generated from an embedded OpenAPI registry; output is a JSON envelope by default and is designed for agents.
The
matterdomain is temporarily withheld while its backend API stabilizes —octo-cli matter ...is not registered and theocto-matterskill is not listed. Do not emitmattercommands until it is re-enabled. The examples below use other domains.
Bots cannot delete documents, even documents they created or own/administer.
Do not invoke docs delete, html rm, or equivalent raw api DELETE calls to
delete a document. Ask a human with document admin permission to delete it in
Octo instead. Do not switch credentials/routes or clear the document's contents
as a workaround. This rule concerns whole documents, not normal editing or
otherwise-permitted comment, version, asset, or sheet row/column removal.
1. Authentication
Bots authenticate with a bearer token. There is no interactive user login — but besides the two bot tokens (app_*, bf_*) there is a third kind, a user API key (uk_*), which carries a real person's identity and is used for message search and the whole drive domain. Two ways to supply any of them:
Stored profile (recommended). A human (or provisioning step) logs the token in once; it is encrypted at rest under ~/.octo-cli, and the raw token never appears in any command line, shell history, or transcript afterward:
# Operator setup (token read from a hidden prompt, or --with-token < file):
octo-cli auth login --bot-id cli_xxxxxxxx # robot id you got when creating the bot
echo "$TOKEN" | octo-cli auth login --bot-id cli_xxxxxxxx --with-token # non-interactive
# A user API key (uk_) is stored the same way — encrypted profile, bot_kind shows
# user_key. Give it a friendly profile name for message search and Drive:
echo "$UK_TOKEN" | octo-cli auth login --profile alice-search-drive --with-token
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today Changed · +24 lines 582676f208a2
- 3d ago Changed · +29 lines b33972a4d811
- 4d ago Changed · +3 lines 9003d4d0562c
- 6d ago Changed · +15 lines d3b52338459d
- 1mo ago Changed · +13 lines 7e589c287a04
- 1mo ago First seen · 226 lines · 42 tokens per session scan A 3bde2402b8ee
octo-shared is a skill published in the GitHub repository Mininglamp-OSS/octo-cli (920 stars, last pushed yesterday), licensed Apache-2.0. It adds 42 tokens to every session and 4,278 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
gh-skill
Manage agent skills with gh skill. Use this skill to discover, preview, install, update, and publish Agent Skills so an agent can self-manage the skills available in its environment.
printing-press-amend
Amend a published CLI from one of two input sources: (1) dogfood mode mines the active Claude Code session transcript for friction (missing flags, hand- rolled API payloads, silent-null returns); (2) direct-input mode accepts user-supplied asks (rename a command, add commands or feeds, fix a named bug, optionally…
printing-press-import
Bring a published CLI from the public library into the internal library so it's identical to a freshly-generated copy — module path reverted, manuscripts placed alongside, ready for /printing-press-polish or /printing-press-emboss. Use when the public library has a CLI you don't have locally, or to recover from a…
agent-manager
Run a fleet of AI coding agents as live tmux sessions with agent-manager. Use when a developer is running more than one coding agent, needs to see which one is working or blocked, wants to spawn another on an independent task, or wants to review an agent's diff without leaving the terminal.
agent-manager-reference
Query agent-manager.dev's reference API and MCP server for documentation, the coding CLIs it manages, the tools its MCP server exposes, and the current release. Use instead of scraping the website's HTML.
code-review
You are a senior code reviewer. You receive diffs via stdin.