repome

Install repome's SKILL.md so your coding agent knows when and how to use repome.

This page is for both humans and agents. It walks through installing the repome CLI, installing the repome SKILL.md where your agent expects to find skills, and verifying setup. Agents that need only the bytes can fetch the canonical markdown directly:

https://repome.sh/skill.md — canonical SKILL.md
https://repome.sh/docs/<slug>.md — raw markdown for any docs page
https://repome.sh/llms.txt — plain-text index of docs

Install the CLI

npm i -g @repome/cli

Verify the install:

repome --help

Install the skill

Use your agent's skill installer, or fetch the raw file directly. For Claude Code:

mkdir -p .claude/skills/repome
curl https://repome.sh/skill.md > .claude/skills/repome/SKILL.md

For Cursor, Cline, or AGENTS.md-based tools, place the same content where your agent looks for skills.

Initialize this project

repome init
repome whoami --json

repome init runs the device-flow login — nothing else to configure; an organization is auto-created at signup. Re-running it is idempotent.

Verify

repome auth status --json
repome doctor

auth status reports which credential is active (env vs file). doctor checks file permissions, server reachability, and the git credential helper.

Hand a repo to another agent

repome share produces everything a second agent needs in one command — a bare-git clone URL with a time-boxed credential, the link-config snippet, and a paste-ready onboarding prompt:

repome share my-api --role write --expires 7d --json

Paste the prompt field (or --out FILE it) into the other agent's instructions. For untrusted channels use repome share --link: the printed https://repome.sh/invites/<id> URL carries no credential, and an agent can redeem it directly as markdown:

curl 'https://repome.sh/invites/<id>.md?reveal=1'

Anonymous repos work the same way with repome anon share <name> — zero auth on either side, and every share dies with the repo.

Prompt for your agent

Copy this into your agent's instructions or paste it as a one-off prompt:

Use the repome skill at https://repome.sh/skill.md. Install it where your
skill system expects, then set up repome in this project: verify the CLI
with JSON output (`repome whoami --json`), and create or link a repo using
the documented repome commands. Report the exact command, exit code, and
structured error if anything fails.

CLI reference

Every subcommand and flag the skill points to.

Anonymous repos

No-account ephemeral repos for cross-agent handoffs.

For agents