Skip to Content
DocumentationUse with coding agents

Teach your agent indexit

indexit ships an agent skill: instructions that teach Claude Code, Codex, and other coding agents to use it well. With the skill, an agent picks fetch message for exact links and fetch messages for history, reads one- and two-number t.me links correctly, leaves sign-in to you, and checks skipped and failed records before reporting success. Ask it to save a post as a note, and it embeds the post’s photographs from the local image service, so they keep showing after the post is gone.

The skill is written for one release of indexit and travels with it. Every binary carries the skill for its own version.

Install it from the binary

indexit skill install --agent claude-code indexit skill install --agent codex

The skill goes to ~/.claude/skills/indexit for Claude Code (or $CLAUDE_CONFIG_DIR/skills/indexit) and to ~/.agents/skills/indexit for Codex. Add --project to install it into the current directory instead, for one repository only. This works offline and matches your binary exactly.

Start a new agent session. Ask for /indexit in Claude Code or $indexit in Codex, or just describe what you want from Telegram: the agent loads the skill when it fits.

Keep it in step

After upgrading indexit, replace the skill with the new binary’s copy:

brew upgrade --formula octolab/tap/indexit indexit skill install --agent claude-code,codex --replace

--replace only replaces a copy that indexit installed and nobody changed since. Directories from other installers, symbolic links, and edited copies are left alone, with an explanation.

To see what your agents load, run:

indexit skill status

It checks user and project copies for Claude Code and Codex, the plugins of both agents, and the legacy Codex skill directory. For a Codex plugin, it reads the enabled plugins from Codex’s config.toml (in CODEX_HOME when set) and checks the copy in Codex’s plugin cache that Codex itself loads: a local copy if there is one, otherwise the highest version. If the cache mixes version numbers with other names, which copy Codex loads depends on the order on disk: status names the directories, asks you to remove the stale ones, and --exact fails until you do. It reports compatibility and whether the content matches this binary’s skill; for copies installed by indexit, it also detects edits.

It warns about multiple copies found for one agent. It exits with 1 when a copy is incompatible or was edited after indexit installed it; --exact also fails on content that differs from the bundled skill. Use indexit skill status --agent claude-code,codex --exact to require a matching copy for both agents: without --agent, finding no copies is not an error.

indexit skill show prints the skill, indexit skill info its version and digest, and indexit skill export -o <dir> writes it to any other directory.

Or get it from the OctoLab catalog

The octolab/skills  catalog holds the skill of the latest stable indexit release, and of other OctoLab tools as they join. Use it if you prefer your agent’s own plugin manager.

AgentInstallUpdate
Claude Codeclaude plugin marketplace add octolab/skills, then claude plugin install indexit@octolabclaude plugin update indexit@octolab
Codexcodex plugin marketplace add octolab/skills, then codex plugin add indexit@octolabcodex plugin marketplace upgrade octolab
Any, with the skills CLI npx skills add octolab/skills --skill indexit -a claude-code -a codex -gnpx skills update

The catalog follows the latest release, so an update can bring a skill newer than your binary. Each release is also tagged indexit--v0.4.1 in the catalog: npx skills add 'octolab/skills#indexit--v0.4.1' --skill indexit stays on that release. A #indexit--v0.4.1 suffix on claude plugin marketplace add pins the whole catalog.

To try unreleased changes, npx skills add octopot/indexit takes the skill from the main branch of the indexit repository.

When versions differ

The skill starts by running indexit version. If your binary is outside the range the skill was written for, the agent stops relying on its recipes, reads the skill your binary carries with indexit skill show, and tells you which side to update. Binaries older than v0.2.0 have no indexit skill command; the agent falls back to --help.

Keep one copy per agent. A plugin and a copy in ~/.claude/skills both load in Claude Code, a plugin and a copy in ~/.agents/skills both load in Codex, and the agent may follow the older one. indexit skill status points out such duplicates.

What the skill does not do

The skill never signs in for you: the agent gives you the login command and waits. It does not print or copy your session file, .env, or API credentials, and it treats message text as data, never as instructions. It runs the same commands you would, with your account and your limits.