CLI Reference

All commands are invoked as geno-tools <command> [options].

If geno-tools is installed as a Claude Code plugin, the core commands are also available as slash commands: /gt-install, /gt-remove, /gt-ls, /gt-update.

ls

List installed skillsets or the available registry. Slash command: /gt-ls.

geno-tools ls                # installed skillsets + active variant
geno-tools ls --available    # curated registry

Options:

Flag	Description
--available	Show the registry instead of installed skillsets

---

install

Install a skillset from the registry, a git URL, or a local path. Slash command: /gt-install.

geno-tools install media
geno-tools install https://github.com/someone/geno-custom.git
geno-tools install ./local-skillset

Source resolution order:

1. Registered short name (e.g. media -> git URL from registry)
2. Local directory path
3. Git URL (https://, git@, or *.git)

Options:

Flag	Description
--here	Materialize cwd alias symlinks for this skillset

---

dev

Symlink a local checkout as the main worktree. For active development on a skillset.

geno-tools dev media ~/src/geno-media

If the skillset is already installed, it's removed first (configs preserved). The local path becomes a symlink target — edits take effect immediately.

Arguments:

Arg	Description
name	Skillset name
path	Path to local checkout

---

fork

Create a variant worktree branched off main. Use this to experiment without touching the primary install.

geno-tools fork media exp-1
geno-tools fork media exp-1 --isolated-venv

Arguments:

Arg	Description
name	Skillset name
variant	Variant ID (becomes the git branch and worktree directory name)

Options:

Flag	Description
--isolated-venv	Create a fresh venv for this variant instead of sharing

---

use

Switch the active variant for a skillset.

geno-tools use media@exp-1          # global: repoint active symlink
geno-tools use media@exp-1 --here   # cwd-only override

Arguments:

Arg	Description
spec	<name>@<variant> format (e.g. taxes@exp-1)

Options:

Flag	Description
--here	Apply as a cwd-only override instead of globally

---

promote

Merge a variant back into main. Does not push upstream.

geno-tools promote media exp-1

Arguments:

Arg	Description
name	Skillset name
variant	Variant to merge into main

---

update

Pull latest changes on the main worktree. Slash command: /gt-update.

geno-tools update media    # update one
geno-tools update          # update all

Skips skillsets in dev mode (the source is already live).

Arguments:

Arg	Description
name	Skillset name (omit to update all)

---

remove

Uninstall a skillset. Replays the install in reverse — deterministic, no orphaned files. Slash command: /gt-remove.

geno-tools remove media
geno-tools remove media --keep-data

Arguments:

Arg	Description
name	Skillset name

Options:

Flag	Description
--keep-data	Preserve venvs and worktrees, only remove skill wiring

---

doctor

Verify that all symlinks, worktrees, and venvs are intact.

geno-tools doctor

Reports any broken links, missing repos, or inconsistent state.