Global options

Flag	Description
`--json`	Output as JSON (for CI/CD pipelines)
`--version`	Show CLI version
`--help`	Show help

Commands that mutate local state return structured success or error details when --json is present, without progress spinners on stdout.

For end-to-end workflows and examples, see Using the CLI.

Commands

Authenticate with a registry instance.

intertool login --url https://your-registry.example.com

For SaaS registries, pass the organization path, such as https://intertool.sh/example-org.

Flag	Description
`--url <url>`	Registry instance URL (required)
`--token <token>`	API key to skip the browser OAuth flow

Opens a browser for OAuth unless --token is provided. Stores credentials in ~/.intertool/config.json.

`logout`

Remove stored credentials.

intertool logout

`whoami`

Show the currently authenticated user and registry URL.

intertool whoami

`search`

Search for skills by keyword.

intertool search "code review"

`install`

Install a skill, MCP server, agent tool, or prompt template into the current project.

intertool install @team/skill-name

Skills / agent tools / prompt templates: writes to .claude/skills/<slug>/SKILL.md
MCP servers: writes to .claude/mcp-servers/<slug>/server.json
Package files: downloads attached files into the same install directory
Metadata: writes .intertool.json so intertool update can compare versions

Automatically adds installed paths to .gitignore.

`remove` (alias: `rm`)

Remove an installed skill or MCP server from the current project.

intertool remove skill-name

`list` (alias: `ls`)

List locally installed skills and MCP servers.

intertool list

`info`

Show detailed information about a skill.

intertool info skill-name

`publish`

Publish a skill to the registry.

intertool publish SKILL.md
intertool publish skill.yaml
intertool publish server.json --type mcp-server --category integrations

Flag	Description
`--name`	Skill name
`--type`	Type: skill, mcp-server, agent-tool, prompt-template
`--description`	Short description
`--category`	Category slug
`--tags`	Comma-separated tags
`--source-url`	Source repository URL

publish auto-detects metadata from SKILL.md frontmatter, skill.yaml, and server.json. MCP server publishes preserve the full server.json configuration for install and raw download.

If the registry requires admin review for new submissions, publish succeeds but the item is submitted for review. It will not appear in search or install results until an owner or admin approves it.

In JSON mode, the response includes status, published, and submitted_for_review so automation can distinguish immediate publishes from review submissions.

`update`

Check installed Intertool items and reinstall any that have a newer registry version.

intertool update
intertool update @team/skill-name

When no name is provided, Intertool scans .claude/skills/*/.intertool.json and .claude/mcp-servers/*/.intertool.json.

`init`

Scaffold a publishable registry item in the current directory.

intertool init --type skill --name "Code Reviewer" --description "Reviews pull requests" --category dev-tools
intertool init --type mcp-server --name "Internal API" --description "Connects to internal APIs"

Flag	Description
`--type`	Type: skill, mcp-server, agent-tool, prompt-template
`--name`	Item name
`--description`	Short description
`--category`	Category slug. Defaults to a type-specific category when omitted interactively
`--tags`	Comma-separated tags

For skills, agent tools, and prompt templates, init writes a SKILL.md with publish metadata. For MCP servers, it writes server.json, README.md, and intertool.yaml; publish server.json reads the sidecar metadata without adding Intertool-only fields to the MCP config.

`completions`

Generate shell completion scripts.

intertool completions bash
intertool completions zsh
intertool completions fish

CLI Reference