Skip to main content

Usage

Prints a summary of one installed in the current project: what it does, every asset it ships, and the command that prints each one. The summary is read from the copy installed on this machine, so facet info never contacts the registry.

Examples

Exit codes

Output

  • Header. Name, installed version, and the free-text author from the facet’s manifest, when it sets one. The author is quoted because the publisher writes it and nothing verifies it.
  • Source. The line under the name says where the summary was read from: your local copy, or a local facet’s source directory.
  • Groups. Skills, commands, agents, and MCP servers, each with its description. An MCP server shows http · <url>, or stdio · <command> <args> and each environment variable with the value the facet sets, such as env: NODE_OPTIONS='--require ./x.js'. These are the publisher’s values, not yours, and they change what the server runs.
  • Status column. installed as <name> when facets.json aliases the asset, and omitted when it is not installed at all. See Materialization.
  • Hints. Each skill, command, agent, and declared file has the facet cat command that prints it. A skill’s companion files are listed under it with +. A binary file shows its size in place of a hint.
  • Files. The manifest, facet.json, and top-level declared files, such as README.md. Print facet.json to check the summary against the raw manifest.

Details

Where the summary comes from

A registry or Git facet is read from its copy in the local cache, and only after that copy is checked against the integrity recorded in facets.lock. A copy that fails the check is reported and left as it is; run facet install to repair it. A local facet is read from its source directory.

Updates

facet info does not check for newer releases. Run facet outdated.

Output is safe to read

Facet text is written by its publisher. Control characters, terminal escape sequences, and invisible or direction-changing Unicode in it, such as the tag characters that can hide text from you while an agent still reads it, are shown as visible escapes (^[, <U+202E>, <U+E0041>) instead of being sent to your terminal. Line breaks in publisher text are shown as spaces, so a description cannot add lines that look like part of the summary. A server URL with a look-alike Unicode host name is shown in its xn-- form, which is the host the client connects to. Hints and stdio server arguments quote anything a shell would otherwise interpret, so a copied command runs as shown. The last line links to the facet’s page on the Agent Facets website. Set FACET_WEB_URL to link to another site. When FACET_REGISTRY_URL points at another registry and FACET_WEB_URL is not set, the line is left out.

See also