Manifa

mani skill

Manifa ships a small agent skill that teaches a coding agent (Claude Code, Codex, Cursor, Gemini, opencode, …) how to drive mani safely — the --json envelope, the exit-code taxonomy, and the consent/scope rules an agent must follow.

The skill is installed automatically on the first mani run after an install or update, into every coding agent you already use (an agent's config dir must already exist — mani never provisions one you don't run). These subcommands give you explicit control; the automatic install is a cheap no-op once it has run for the current version.

Disable the automatic install entirely with MANIFA_NO_SKILL_INSTALL=1.

Supports --json for scripting (the machine value lists the detected agents and install state — paths and versions only, never any secret).

Usage

mani skill [OPTIONS] <COMMAND>

Commands

  • install — Install (or refresh) the skill into every coding agent you already use
  • status — Show which coding agents were detected and the installed skill version
  • uninstall — Remove the Manifa skill from your coding agents' skill directories
  • help — Print this message or the help of the given subcommand(s)

Detection

For each supported agent whose base config dir exists under $HOME, the skill is written to <skills-dir>/manifa/{SKILL.md,reference.md}:

~/.claude/skills/manifa/
~/.codex/skills/manifa/
~/.cursor/skills/manifa/
~/.gemini/skills/manifa/
~/.config/opencode/skill/manifa/

mani skill install

Install (or refresh) the skill into every detected agent. Idempotent: an up-to-date copy is left untouched.

Usage

mani skill install [OPTIONS]

Options

mani skill install --force

Reinstall even when the current version is already present.

mani skill install --json

Output machine-readable JSON: the installed version and the list of agent skill dirs written.

mani skill status

Show which coding agents were detected and whether each holds the Manifa skill (and at what version).

Usage

mani skill status [OPTIONS]

mani skill uninstall

Remove the Manifa skill from your coding agents' skill directories.

Usage

mani skill uninstall [OPTIONS]

Options

mani skill --json

Output machine-readable JSON instead of the human table. Stable field names for scripting.

mani skill --quiet

Suppress progress and chatter — print only results and errors (alias: -q).

mani skill --help

Print help (alias: -h).