Skip to main content

​
Usage

Opens the authoring workbench for the facet in the given directory. It does everything facet create can, plus reconciling the manifest against what is actually on disk. Nothing is written until you confirm. Exit with Esc twice to discard everything.
facet edit needs a terminal. For scripted edits use facet modify.

​
Exit codes

​
Details

​
Reconciliation

When the manifest and disk disagree, you resolve that first:
  • New text assets on disk: add them to the manifest, or ignore.
  • Undeclared files inside a declared skill: adopt them as companion files, or ignore.
  • Root files such as LICENSE: adopt into the top-level files, or ignore.
  • Declared files missing from disk: scaffold a template at the declared path, or drop the declaration.
Ignored files stay on disk and undeclared. README.md and README are handled by the README panel instead, so they never appear twice.

​
Editing

  • Change the facet name, description, and version.
  • Switch between public and private without opening facet.json.
  • Add, remove, or rename skills, agents, and commands. Deleting a skill removes its declared companions, while files you added to that directory yourself are preserved.
  • Edit a text asset’s description in your terminal editor, using $VISUAL, $EDITOR, or vi.
Text-asset metadata lives in the manifest, so the editor never writes front matter into an asset file.

​
README panel

Both README.md and the extensionless README get their own panel: Adopting preserves the existing bytes unless you edit them.

​
Confirmation

The summary shows the final identity, privacy intent, and assets, plus every queued file operation with its exact path. A privacy change takes effect at build time, so rebuild afterwards and bump the version if it was already published. Applying writes facet.json, scaffolds new text-asset templates, deletes files for removed text assets, and applies your README and supplementary-file choices together.

​
Troubleshooting

Cause: the workbench cannot run without a TTY.Fix: use facet modify, which makes the same changes one flag at a time.
Cause: facet.json is missing from the directory, or it is not valid JSON.Fix: run facet edit from the facet’s root, or repair the file. To scaffold a new facet instead, use facet create.

​
See also