Skip to main content

​
Usage

Signs in to the registry by pasting a personal access token (PAT). Requires an interactive terminal.

​
Exit codes

​
What it does

1

Prompt for token

Presents an interactive menu. Select “Paste a token” and paste the PAT from your account at agentfacets.io.
2

Verify token

Calls GET /v0/auth/me to confirm the token is valid. A typo or expired token fails immediately with the registry’s own error message, and you are reprompted.
3

Persist credential

Writes the verified token to $FACET_DIR/credentials (default ~/.facet/credentials) in INI format with mode 0600.

​
Credential file format

The file is created with 0600 permissions so only the current user can read it.

​
Token precedence

When both FACET_TOKEN and the credentials file are present, FACET_TOKEN takes precedence. The login command notes this so the environment variable does not silently shadow the file.

​
See also