Pre-Release Alpha

The alpha is the current phase. The core loop — author, publish, discover, install — is live end to end against the public registry at agentfacets.io.

​

Shipped

Authoring

• facet create — scaffold a facet, interactively or headless via flags
• facet edit — interactive authoring workbench with disk/manifest reconciliation
• facet modify — headless, scriptable edits (assets, metadata, adapter config)
• facet build — validate and package; --verify for a no-output validation pass, --json for machine-readable results

Registry

• facet publish — upload with drift detection and immutable versions
• facet search — discover published facets
• facet login / facet whoami / facet logout — token-based auth

Project management

• facet add — add and install in one step, registry-first source grammar
• facet install — lockfile-driven reproducible installs, --frozen-lockfile for CI
• facet remove — transactional removal (aliased rm)
• facet list — see what’s declared and resolved

Platform

• facet adapter — install/list/remove adapters; first-party adapters for Claude Code, OpenCode, and Codex; a public adapter SDK for building your own
• facet instructions — built-in usage guidance for AI agents
• facet self-update — update the CLI in place

​

Alpha caveats

• Published versions are immutable, but registry policies (review queues, name reservations) are still being tuned.
• Breaking CLI changes may still ship between alpha versions — check the changelog.

See the beta goals for what’s next.