CLI Reference

CLI Reference

Installation

cargo build --release -p frameshift-cli
# Binary: target/release/frameshift-cli

Commands

frameshift use <name> --from <library>

Install, activate, and print the rendered persona in one call.

frameshift use cryptographic --from ./personas

frameshift install <name@version> [--from-path <dir>]

Install a persona pack into the central cache.

frameshift install cryptographic@0.1.0 --from-path ./personas/cryptographic

frameshift activate <name>

Set the active persona for the current project.

frameshift activate cryptographic

frameshift select [--task TEXT] [--library DIR] [--format table|json]

Score and rank personas without activating. Useful for inspecting the selection pipeline.

# Table output:
frameshift select --task "debug a rust compilation error" --library ~/.local/share/frameshift/personas

# JSON output for programmatic use:
frameshift select --task "debug a rust compilation error" --format json

JSON output includes: context snapshot (detected languages, frameworks, inferred intent), per-candidate component scores, matched tokens, and rationale.

frameshift automate on [--sensitivity 0.0-1.0]

Enable automate mode for the current project.

frameshift automate on
frameshift automate on --sensitivity 0.7

frameshift automate off

Disable automate mode.

frameshift automate status

Print mode state: on/off, sensitivity, currently active persona.

frameshift automate lock

Pin the current persona. Prevents automate mode from switching.

frameshift automate unlock

Release the pin. Automate mode resumes switching.

frameshift feedback --chosen <name> [--auto-pick <name>] [--intent <intent>] [--reason <text>]

Record a selection override for preference learning.

frameshift feedback --auto-pick web-designer --chosen rust --intent debugging

frameshift prefs [show|reset]

View or reset per-persona preference biases.

frameshift prefs show
frameshift prefs reset

frameshift grow append <persona> <text>

Append an entry to a persona's growth log.

frameshift grow append rust "orphan rules prevent implementing foreign traits on foreign types"

frameshift sync

Reconcile the central store with the project lockfile. Reports what is installed and whether anything is out of date.

frameshift gc

Remove unreferenced cache entries. Safe to run at any time.

frameshift diff <a> <b>

Semantic diff between two personas (typed source).

frameshift render <persona>

Re-render persona source to per-agent markdown.

frameshift migrate

Move legacy files (.frameshift.toml, .frameshift.lock, growth.md) from the project root into the central store.

frameshift verify <persona>

Run conformance checks against a persona.

frameshift publish <persona>

Publish a persona pack to the marketplace.

frameshift project-id

Print the SHA-256 project ID for the current directory.

frameshift rule add|remove

Patch rules in persona source (typed TOML operations).

frameshift skill add|remove

Patch skills in persona source (typed TOML operations).