Usage
facet create can do, plus automatic reconciliation of disk state versus the manifest.
What it does
The edit command has two phases:Reconciliation
If the edit command detects drift between the manifest and the files on disk, it enters a reconciliation phase first. Drift includes:- New files on disk not tracked in the manifest — choose “Add to manifest” or “Ignore for now”
- Missing files declared in the manifest but absent from disk — choose “Scaffold template” or “Remove from manifest”
name, description, and any per-adapter extras at install time.
All reconciliation items must be resolved before proceeding to editing.
Editing
After reconciliation (or immediately if no drift), the edit phase allows:- Identity editing — modify the facet name, description, and version
- Privacy editing — inspect the facet’s current visibility intent without opening
facet.json, and switch between Public and Private. - Asset management — add, remove, or rename skills, agents, and commands
- Description editing — press Enter on an asset to edit its name, or press ↓ during name editing to open the description in your terminal editor (
$VISUAL/$EDITOR/vi)
Confirmation
Before applying, a summary shows the final state of your facet — identity fields, the privacy intent, and all assets with their descriptions — along with a reminder that a privacy change is embedded at build time (rebuild to apply it, and bump the version if it was already published). Choose “Apply” to write changes or “Go back” to continue editing. On apply, the edit command:- Writes the updated
facet.json - Scaffolds template files for new assets
- Deletes files for removed assets
Exit codes
| Code | Meaning |
|---|---|
0 | Changes applied successfully |
1 | Cancelled or manifest invalid |