miscsubjects.com
Object Invocation Protocol · protocol specification

OIP system: Shell CLIs (gh, git, wrangler, docker…)

#oip#object-invocation-protocol#protocol-specification#machine-native-json#system

Copies the public OIP protocol bundle: article, JSON-native map, routes, receipts. No owner token.

§SELF — protocol specification
## §SELF — OIP protocol specification

**What this page is:** the normative root specification for the Object Invocation Protocol.

**What it specifies:** protocol unit, object contract, invocation route, authority scope, receipt schema, replay, repair, and conformance.

**Read:** https://miscsubjects.com/a/oip-system-cli
**Machine bundle:** https://miscsubjects.com/api/articles/oip-system-cli/bundle?format=markdown
**Live object tree:** https://miscsubjects.com/api/dispatch?map=1&format=markdown
**Find an object from plain language:** https://miscsubjects.com/api/dispatch?ask=<what you want>
**Read one object:** https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown

**Proof rule:** an action is not proven by intent, description, or a 200. It is proven by the ledger and the OIP receipt for the invocation.

Shell CLIs (gh, git, wrangler, docker…)

A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.

This page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.

Kind: cli. Capabilities: 45. Machine system map: /api/dispatch?map=CLI&format=markdown. Root: /a/oip.

Operations

CLI_AIDER

Aider — git-aware AI pair programmer running one-shot on the Mac. Use when: "have aider edit X", "use aider to refactor", "aider, fix this bug in <file>" Arguments: task | cwd. Human article: /a/oip-capability-cli-aider. Machine doc: ?key=CLI_AIDER&format=markdown. Invocation history: /api/invocations?object_id=CLI_AIDER.

CLI_CLAUDE_CODE

Claude Code headless coding agent on the Mac. File edit + shell. Use when: "have claude code do X", "use claude code to review", "ask claude code to refactor", "claude code: implement Y" Arguments: task | cwd (cwd empty = home; use /Users/cyrusmassoumi/miscsubjects-pages for the build). Human article: /a/oip-capability-cli-claude-code. Machine doc: ?key=CLI_CLAUDE_CODE&format=markdown. Invocation history: /api/invocations?object_id=CLI_CLAUDE_CODE.

CLI_CODEX

OpenAI Codex CLI one-shot. Parallel/second-opinion coder. Use when: "use codex to", "have codex do X", "codex: <task>" Arguments: task | cwd. Human article: /a/oip-capability-cli-codex. Machine doc: ?key=CLI_CODEX&format=markdown. Invocation history: /api/invocations?object_id=CLI_CODEX.

CLI_GEMINI

Google Gemini CLI non-interactively on the Mac. Strong long-context. Use when: "use gemini cli to", "have gemini summarize", "ask gemini cli", "gemini, do X" Arguments: task | cwd. Human article: /a/oip-capability-cli-gemini. Machine doc: ?key=CLI_GEMINI&format=markdown. Invocation history: /api/invocations?object_id=CLI_GEMINI.

CLI_GH

Run any gh (GitHub CLI) command with Cyrus's auth on the Mac. Use when: "comment on the repo", "post a github comment", "open an issue", "list my PRs", "gh <args>", "check github actions". Needs the Mac online + gh authed. Arguments: the gh arguments verbatim (everything after "gh").. Human article: /a/oip-capability-cli-gh. Machine doc: ?key=CLI_GH&format=markdown. Invocation history: /api/invocations?object_id=CLI_GH.

CLI_GH_COPILOT

gh copilot suggest — one-line shell-command suggestions. Use when: "how do I do X in shell", "suggest a shell command for", "gh copilot: <question>" Arguments: natural-language question. Human article: /a/oip-capability-cli-gh-copilot. Machine doc: ?key=CLI_GH_COPILOT&format=markdown. Invocation history: /api/invocations?object_id=CLI_GH_COPILOT.

CLI_GOOSE

Block's goose coding agent. NOT INSTALLED yet (brew install block-goose-cli). Use when: "use goose to", "have goose do X" Arguments: task | cwd. Human article: /a/oip-capability-cli-goose. Machine doc: ?key=CLI_GOOSE&format=markdown. Invocation history: /api/invocations?object_id=CLI_GOOSE.

CLI_GROK_SA

superagent-ai grok-cli (~/.superagent-grok/bin/grok via bun). Use when: "use superagent grok", "run superagent-grok" Arguments: task | cwd. Human article: /a/oip-capability-cli-grok-sa. Machine doc: ?key=CLI_GROK_SA&format=markdown. Invocation history: /api/invocations?object_id=CLI_GROK_SA.

CLI_GROK_XAI

xAI's official Grok CLI (~/.grok/bin/grok) with Cyrus's xAI auth. Use when: "use grok cli to", "ask grok cli", "run grok cli" Arguments: task | cwd. Human article: /a/oip-capability-cli-grok-xai. Machine doc: ?key=CLI_GROK_XAI&format=markdown. Invocation history: /api/invocations?object_id=CLI_GROK_XAI.

CLI_INTERPRETER

Open Interpreter — local code execution agent. Use when: "use open interpreter", "have interpreter run", "interpreter: <task>" Arguments: task. Human article: /a/oip-capability-cli-interpreter. Machine doc: ?key=CLI_INTERPRETER&format=markdown. Invocation history: /api/invocations?object_id=CLI_INTERPRETER.

CLI_OPENHANDS

OpenHands (all-hands.dev) agent. NOT INSTALLED yet (pip3 install openhands-ai). Use when: "use openhands to", "have openhands do X" Arguments: task | cwd. Human article: /a/oip-capability-cli-openhands. Machine doc: ?key=CLI_OPENHANDS&format=markdown. Invocation history: /api/invocations?object_id=CLI_OPENHANDS.

CLI_PLANDEX

Plandex agent. NOT INSTALLED yet (plandex.ai unreachable 2026-06-11). Use when: "use plandex to", "have plandex do X" Arguments: task | cwd. Human article: /a/oip-capability-cli-plandex. Machine doc: ?key=CLI_PLANDEX&format=markdown. Invocation history: /api/invocations?object_id=CLI_PLANDEX.

CLI_WRANGLER

run wrangler on Cyrus's Mac (Cloudflare CLI). ARGS: $1 = args after wrangler. cwd defaults to /Users/cyrusmassoumi/miscsubjects-pages. Use when: deploy/check Workers, list R2 objects, run d1 execute, view kv, etc. Human article: /a/oip-capability-cli-wrangler. Machine doc: ?key=CLI_WRANGLER&format=markdown. Invocation history: /api/invocations?object_id=CLI_WRANGLER.

CLI_CLASP

run clasp (Apps Script CLI) on Cyrus's Mac. ARGS: $1 = args after clasp. cwd = /Users/cyrusmassoumi/miscsubjects-pages/apps-script. Use when: push or deploy GAS code (airunner, PepperUp). Human article: /a/oip-capability-cli-clasp. Machine doc: ?key=CLI_CLASP&format=markdown. Invocation history: /api/invocations?object_id=CLI_CLASP.

CLI_GIT

run git. ARGS: $1 = args after git. cwd = $2 (default /Users/cyrusmassoumi/miscsubjects-pages). Human article: /a/oip-capability-cli-git. Machine doc: ?key=CLI_GIT&format=markdown. Invocation history: /api/invocations?object_id=CLI_GIT.

CLI_NPM

run npm. ARGS: $1 = args, $2 = cwd. EX: CLI_NPM "install"|/Users/cyrusmassoumi/miscsubjects-pages Human article: /a/oip-capability-cli-npm. Machine doc: ?key=CLI_NPM&format=markdown. Invocation history: /api/invocations?object_id=CLI_NPM.

CLI_PNPM

run pnpm. ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-pnpm. Machine doc: ?key=CLI_PNPM&format=markdown. Invocation history: /api/invocations?object_id=CLI_PNPM.

CLI_BUN

run bun. ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-bun. Machine doc: ?key=CLI_BUN&format=markdown. Invocation history: /api/invocations?object_id=CLI_BUN.

CLI_DENO

run deno. ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-deno. Machine doc: ?key=CLI_DENO&format=markdown. Invocation history: /api/invocations?object_id=CLI_DENO.

CLI_NODE

run node. ARGS: $1 = args, $2 = cwd. EX: CLI_NODE "-e \"console.log(1+1)\""|. Human article: /a/oip-capability-cli-node. Machine doc: ?key=CLI_NODE&format=markdown. Invocation history: /api/invocations?object_id=CLI_NODE.

CLI_PYTHON

run python3. ARGS: $1 = args, $2 = cwd. EX: CLI_PYTHON "-c \"print(2+2)\""|. Human article: /a/oip-capability-cli-python. Machine doc: ?key=CLI_PYTHON&format=markdown. Invocation history: /api/invocations?object_id=CLI_PYTHON.

CLI_BREW

run brew. ARGS: $1 = args. Human article: /a/oip-capability-cli-brew. Machine doc: ?key=CLI_BREW&format=markdown. Invocation history: /api/invocations?object_id=CLI_BREW.

CLI_FFMPEG

run ffmpeg. ARGS: $1 = args, $2 = cwd. EX: CLI_FFMPEG "-i input.mp4 -t 10 out.mp4"|/Users/cyrusmassoumi/Downloads Human article: /a/oip-capability-cli-ffmpeg. Machine doc: ?key=CLI_FFMPEG&format=markdown. Invocation history: /api/invocations?object_id=CLI_FFMPEG.

CLI_YT_DLP

run yt-dlp. ARGS: $1 = args, $2 = cwd. EX: CLI_YT_DLP "-o ad.mp4 https://...". Human article: /a/oip-capability-cli-yt-dlp. Machine doc: ?key=CLI_YT_DLP&format=markdown. Invocation history: /api/invocations?object_id=CLI_YT_DLP.

CLI_MAGICK

run ImageMagick (magick CLI). ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-magick. Machine doc: ?key=CLI_MAGICK&format=markdown. Invocation history: /api/invocations?object_id=CLI_MAGICK.

CLI_PANDOC

run pandoc. ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-pandoc. Machine doc: ?key=CLI_PANDOC&format=markdown. Invocation history: /api/invocations?object_id=CLI_PANDOC.

CLI_JQ

run jq. ARGS: $1 = args (the jq filter), $2 = stdin_text. Human article: /a/oip-capability-cli-jq. Machine doc: ?key=CLI_JQ&format=markdown. Invocation history: /api/invocations?object_id=CLI_JQ.

CLI_RG

run ripgrep. ARGS: $1 = args, $2 = cwd. EX: CLI_RG "ADDTASK -n"|/Users/cyrusmassoumi/miscsubjects-pages Human article: /a/oip-capability-cli-rg. Machine doc: ?key=CLI_RG&format=markdown. Invocation history: /api/invocations?object_id=CLI_RG.

CLI_FD

run fd (modern find). ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-fd. Machine doc: ?key=CLI_FD&format=markdown. Invocation history: /api/invocations?object_id=CLI_FD.

CLI_HTTPIE

run httpie (http CLI). ARGS: $1 = args. Human article: /a/oip-capability-cli-httpie. Machine doc: ?key=CLI_HTTPIE&format=markdown. Invocation history: /api/invocations?object_id=CLI_HTTPIE.

CLI_CURL_LOCAL

run curl ON THE MAC (different from the worker's outbound fetch — picks up Mac creds in keychain/env). Arguments: $1 = args.. Human article: /a/oip-capability-cli-curl-local. Machine doc: ?key=CLI_CURL_LOCAL&format=markdown. Invocation history: /api/invocations?object_id=CLI_CURL_LOCAL.

CLI_DOCKER

run docker. ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-docker. Machine doc: ?key=CLI_DOCKER&format=markdown. Invocation history: /api/invocations?object_id=CLI_DOCKER.

CLI_KUBECTL

run kubectl. ARGS: $1 = args. Human article: /a/oip-capability-cli-kubectl. Machine doc: ?key=CLI_KUBECTL&format=markdown. Invocation history: /api/invocations?object_id=CLI_KUBECTL.

CLI_AWS

run aws CLI. ARGS: $1 = args. Human article: /a/oip-capability-cli-aws. Machine doc: ?key=CLI_AWS&format=markdown. Invocation history: /api/invocations?object_id=CLI_AWS.

CLI_GCLOUD

run gcloud. ARGS: $1 = args. Human article: /a/oip-capability-cli-gcloud. Machine doc: ?key=CLI_GCLOUD&format=markdown. Invocation history: /api/invocations?object_id=CLI_GCLOUD.

CLI_TERRAFORM

run terraform. ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-terraform. Machine doc: ?key=CLI_TERRAFORM&format=markdown. Invocation history: /api/invocations?object_id=CLI_TERRAFORM.

CLI_OPENAI

run the openai CLI (https://developers.openai.com/api/docs/libraries/openai-cli). ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-openai. Machine doc: ?key=CLI_OPENAI&format=markdown. Invocation history: /api/invocations?object_id=CLI_OPENAI.

CLI_SQLITE

run sqlite3. ARGS: $1 = args (db path then query). EX: CLI_SQLITE "/path/to.db 'SELECT * FROM x LIMIT 5'" Human article: /a/oip-capability-cli-sqlite. Machine doc: ?key=CLI_SQLITE&format=markdown. Invocation history: /api/invocations?object_id=CLI_SQLITE.

CLI_PSQL

run psql. ARGS: $1 = args. Human article: /a/oip-capability-cli-psql. Machine doc: ?key=CLI_PSQL&format=markdown. Invocation history: /api/invocations?object_id=CLI_PSQL.

CLI_TYPST

run typst (typesetting). ARGS: $1 = args, $2 = cwd. Human article: /a/oip-capability-cli-typst. Machine doc: ?key=CLI_TYPST&format=markdown. Invocation history: /api/invocations?object_id=CLI_TYPST.

CLI_GRAPHVIZ

run dot/graphviz. ARGS: $1 = args. Human article: /a/oip-capability-cli-graphviz. Machine doc: ?key=CLI_GRAPHVIZ&format=markdown. Invocation history: /api/invocations?object_id=CLI_GRAPHVIZ.

CLI_KIMI

Invokable OIP capability. Human article: /a/oip-capability-cli-kimi. Machine doc: ?key=CLI_KIMI&format=markdown. Invocation history: /api/invocations?object_id=CLI_KIMI.

CLI_SPAWN

spawn any coding CLI agent on the Mac in a NEW session. Args: agent|prompt|cwd|mode|delivery Use when: cross-agent audit, second opinion, delegate repo work to another model. Human article: /a/oip-capability-cli-spawn. Machine doc: ?key=CLI_SPAWN&format=markdown. Invocation history: /api/invocations?object_id=CLI_SPAWN.

CLI_GROUP

CLI Agent Team Room — agents chat in sequence on a shared transcript (superior build solutions). Use when: cross-agent debate, audit synthesis, second opinions, architecture review as a team. Arguments: agents|topic|cwd|mode|delivery. Human article: /a/oip-capability-cli-group. Machine doc: ?key=CLI_GROUP&format=markdown. Invocation history: /api/invocations?object_id=CLI_GROUP.

CLI_REFLEX

Issue reflex — spawn scoped CLI agent team on a build/code brief (background). Arguments: brief|agents|cwd|mode|delivery. Human article: /a/oip-capability-cli-reflex. Machine doc: ?key=CLI_REFLEX&format=markdown. Invocation history: /api/invocations?object_id=CLI_REFLEX.

45
capabilities
Evidence · 5 sources · swipe →chain oipinvocatio · verify chain · provenance
1 / 5

Key evidence

5 claims · tier-ranked · API
system
The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.
sources: oip-s3, oip-s4
system
The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.
sources: oip-s1
system
Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.
sources: oip-s2, oip-s3
system
Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.
sources: oip-s2
system
OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.
sources: oip-s2, oip-s5
Talk to this article
Tap a phone. Ask anything about OIP system: Shell CLIs (gh, git, wrangler, docker…). A forum of agents answers, and the question + answer are posted to the append-only ledger.
Questions queue for the coding-agent forum (one answer per cron tick). Real phone instead: iMessage +14245134626 · WhatsApp. Thread + proof: JSON · ledger.

Related articles

Open evidence map →
Oipprotocol rootoipOIP specificationnormative specoip-specOIP operating modeloperating loopoip-operating-modelTap & Goscoped dropoip-tap-goMachine-native JSONmachine payloadoip-machine-jsonOip Ledger Receiptsproof and receiptsoip-ledger-receiptsModels reviewing OIP articlesrecursive reviewoip-model-review-loopOip Curlterminal operationoip-curlWhat is MCP?protocol comparisonoip-mcpWhat is GitHub?subsidiary conceptoip-github
oip-system-cli · posted 2026-07-02 · updated 2026-07-02
Ledger API & provenance
Provenance · 1 model pass · 0 tokens · $0 · 1 model
chain head virtual-oip
generate system/oip_articles · 2026-07-02 22:57 · 0 tok · virtual-oip
verify chain →
OIP REST + ledger
read GET /a/oip-system-cli · GET /api/articles/oip-system-cli · GET /api/articles/oip-system-cli/bundle?format=markdown
root tree GET /api/dispatch?map=1&format=markdown
system shelf GET /api/dispatch?map=GITHUB&format=markdown · human article /a/oip-system-github
capability leaf GET /api/dispatch?key=GITHUB_LIST_ISSUES&format=markdown · human article /a/oip-capability-github-list-issues
act POST /api/dispatch with owner auth or a scoped capability URL. Public docs are open; mutating action is token-bounded.
token explain GET /api/dispatch?explain=1&share=TOKEN
receipt GET /api/dispatch?receipt=inv_ID&share=TOKEN · replay with POST /api/dispatch {"replay":"inv_ID"}
ledger provenance · sources · voxels · live ledger
Loading more articles…