{"slug":"add-rtk","title":"add-rtk","summary":"Install rtk token-compression proxy into agent containers. Routes Bash tool calls through rtk for 60–90% token savings on dev commands (git, cargo, pytest, docker, kubectl, etc.).","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-24T05:37:17.999337Z","repo":{"url":"https://github.com/nanocoai/nanoclaw","stars":30867,"forks":12793,"license":"MIT","updatedAt":"2026-10-01T15:15:04Z"},"bodyHtml":"
\n

name: add-rtk\ndescription: Install rtk token-compression proxy into agent containers. Routes Bash tool calls through rtk for 60–90% token savings on dev commands (git, cargo, pytest, docker, kubectl, etc.).

\n

Add rtk

\n

Install rtk — a CLI proxy delivering 60–90% token savings on common dev commands (git, cargo, pytest, docker, kubectl, etc.) — and wire it transparently into agent containers via the Claude Code PreToolUse hook.

\n

What this sets up

\n\n

Integration tests

\n

This skill has no in-tree integration test by design. Its only functional reach-ins are runtime operator actions — the host-only ncl groups config add-mount (Step 3) and the settings.json PreToolUse hook write (Step 4) — neither of which leaves a line in the source tree whose deletion a test could catch. There are no package dependencies or Dockerfile edits to guard either. Conformance is idempotent apply + REMOVE.md; the mount and hook are verified at runtime (see Verify).

\n

Step 1 — Install rtk on the host

\n
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh\n
\n

If the script put the binary elsewhere, move it:

\n
find ~/.local ~/.cargo/bin ~/bin -name rtk 2>/dev/null\nmv \"$(which rtk 2>/dev/null)\" ~/.local/bin/rtk\n
\n

Verify:

\n
~/.local/bin/rtk --version\nchmod +x ~/.local/bin/rtk   # if needed\n
\n

Step 2 — Identify the target agent group

\n
ncl groups list\n
\n

Note the group ID (e.g. ag-1776342942165-ptgddd). Repeat Steps 3–5 for each group.

\n

Step 3 — Mount rtk into the container config

\n

Mount the host rtk binary read-only into the container with the host-only add-mount verb. It is idempotent — re-running skips the entry if it is already present:

\n
ncl groups config add-mount --id <group-id> \\\n  --host ~/.local/bin/rtk \\\n  --container /usr/local/bin/rtk \\\n  --ro\n
\n

This verb is operator-only and runs host-side (via /setup, /customize, or /manage-mounts); it is rejected from inside a container.

\n

The host root (~/.local/bin) must also be in the external mount allowlist at ~/.config/nanoclaw/mount-allowlist.json for the mount to take effect at spawn. Add it there if it isn't already.

\n

Verify:

\n
ncl groups config get --id <group-id>\n# Look for the /usr/local/bin/rtk mount\n
\n

Step 4 — Add the PreToolUse hook to settings.json

\n

Each agent group has a settings.json at:

\n
data/v2-sessions/<group-id>/.claude-shared/settings.json\n
\n

This file is mounted at /home/node/.claude/settings.json inside the container and is read by Claude Code for hooks, env, and model config.

\n

Add the PreToolUse entry with jq. This drops any existing rtk Bash hook first, then appends a fresh one, so it is safe to re-run without creating duplicates:

\n
SETTINGS=\"data/v2-sessions/<group-id>/.claude-shared/settings.json\"\n\njq '.hooks.PreToolUse = ((.hooks.PreToolUse // [])\n      | map(select((.hooks // []) | any(.command == \"rtk hook claude\") | not)))\n    + [{\"matcher\":\"Bash\",\"hooks\":[{\"type\":\"command\",\"command\":\"rtk hook claude\"}]}]' \\\n  \"$SETTINGS\" > /tmp/rtk-settings.json && mv /tmp/rtk-settings.json \"$SETTINGS\"\n
\n

Step 5 — Restart the container

\n
ncl groups restart --id <group-id>\n
\n

Verify

\n

Confirm the binary is executable inside the container so a missing or non-executable mount surfaces immediately rather than as a silent hook failure:

\n
docker exec \"$(docker ps --filter \"name=<group-id>\" --format '{{.Names}}' | head -1)\" rtk --version\n
\n

Then ask the agent to run git status or any other supported command. rtk intercepts it silently. Check savings with:

\n
~/.local/bin/rtk gain\n
\n

Troubleshooting

\n

rtk: command not found inside the container

\n

Mount wasn't applied or container wasn't restarted:

\n
ncl groups config get --id <group-id>\n# Look for the /usr/local/bin/rtk mount\nncl groups restart --id <group-id>\n
\n

Hook not firing

\n

Verify the hook is in settings.json:

\n
jq '.hooks.PreToolUse' data/v2-sessions/<group-id>/.claude-shared/settings.json\n
\n

If missing, re-run Step 4.

\n

Binary won't execute — permission denied

\n
chmod +x ~/.local/bin/rtk\n
\n","files":[{"path":"REMOVE.md","sizeBytes":1221,"isText":true},{"path":"SKILL.md","sizeBytes":4554,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-08-24T05:39:03.351372Z","sha256":"8C917F2A93364C9D989E69EBB3C33C886E883BB7D24B26DEF393766EA1671971","sizeBytes":2762},"review":null,"source":{"repositoryUrl":"https://github.com/nanocoai/nanoclaw","path":".claude/skills/add-rtk","license":"MIT","commit":"962d527cf20f82d84372ea8cd6ab30e9acbeb868","subtreeSha":"9EFB9825C97796A113DCFAC2DD84B890AEC49E14BF87CD6C825FA7A415079F09","lastSyncedAt":"2026-10-01T15:23:47.22384Z"},"reviewedAt":"2026-08-24T05:45:23.24485Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/nanocoai/nanoclaw/tree/main/.claude/skills/add-rtk"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install nanocoai-nanoclaw@llmmart"},{"target":"git","command":"git clone https://github.com/nanocoai/nanoclaw.git"}]}