Frameshift v0.9.9

Frameshift v0.9.9

First public release of the Frameshift engine: a runtime for versioned, composable behavioral personas for AI coding agents, agent-agnostic by design.

This is v0.9.9, not v1.0. The engine itself is feature-complete and tested; the project's website frontend and desktop app are still in development. v1.0 ships when the full surface is usable.

Highlights

• 24-crate Rust workspace under Elastic License 2.0: CLI, client engine, pack tooling, composition, conformance, catalog, memory, vault, object storage, HTTP server, MCP server, watch daemon, persona orchestrator, growth log.
• Single-shot persona activation. frameshift use <name> --from <library> installs on demand, activates, and prints the rendered persona body in one call.
• Persona orchestration subsystem (frameshift-orchestrator):
  • Context sensor: project signals + task hint compose a structured ContextSignal.
  • Dual-source persona index: typed persona.toml or freeform AGENTS.md + pack.toml.
  • Selection policy: IDF-weighted lexical scoring, F1 language matching, capability bonus, learned per-project override bias. Every result carries a confidence and a human-readable rationale.
  • Drift-control state machine: Off / Armed / Active / Locked, with margin + debounce + explicit lock so it does not thrash mid-session.
  • Override-feedback learning, durable per-project mode state, append-only audit log.
• Identical selection on every surface. CLI, MCP server, and watch daemon all share one orchestrator::select entry point. Any MCP-capable agent gets the full feature.
• Per-project automate mode, OFF by default. Keyed by project_id = sha256(realpath(project_root)); turning it on in one project does not affect any other.

Quick start

# Activate any persona from a library directory in one call:
frameshift use cryptographic --from ./personas

# Get ranked candidates for the current project + task:
frameshift select --task "harden auth and threat model the API" --library ./personas

# Enable per-project automate mode:
frameshift automate on
frameshift automate status

The complete CLI surface:

frameshift install <name@version> [--from-path <dir>]
frameshift activate <name>
frameshift use <name> --from <library>
frameshift select [--task TEXT] [--library DIR]
frameshift automate <on|off|status|lock|unlock>
frameshift sync
frameshift grow append <persona> <text>
frameshift migrate
frameshift gc
frameshift project-id

Installation

Download the Linux x86_64 build attached to this release, verify the checksum, extract, and place frameshift on your PATH:

curl -LO https://github.com/Ghost-Frame/FrameShift/releases/download/v0.9.9/frameshift-v0.9.9-x86_64-unknown-linux-gnu.tar.gz
curl -LO https://github.com/Ghost-Frame/FrameShift/releases/download/v0.9.9/frameshift-v0.9.9-x86_64-unknown-linux-gnu.tar.gz.sha256
sha256sum -c frameshift-v0.9.9-x86_64-unknown-linux-gnu.tar.gz.sha256
tar xzf frameshift-v0.9.9-x86_64-unknown-linux-gnu.tar.gz
install -m 0755 frameshift-v0.9.9-x86_64-unknown-linux-gnu/frameshift ~/.local/bin/
frameshift --version

Other platforms: build from source.

git clone https://github.com/Ghost-Frame/FrameShift.git
cd FrameShift
cargo build --release -p frameshift-cli

Verification

SHA256 (frameshift-v0.9.9-x86_64-unknown-linux-gnu.tar.gz)
4209f1e162996960eb8c2156b59a09b5a660dfdb967c05ec8a9314e35b4c7de0

The release tag v0.9.9 is SSH-signed.

What is not in v0.9.9

• Website frontend (in development; v1.0 gate).
• Desktop app (in development; v1.0 gate).
• Marketplace server is wired in the workspace but not publicly hosted yet.
• The typed-source persona format (persona.toml with separate rules.toml and skills.toml, semantic diffs, patch operations) lives in frameshift-source as the next-generation representation. The live install path uses freeform AGENTS.md today.

License

Elastic License 2.0. See LICENSE. Commercial licensing: support@syntheos.dev.