Skip to main content

​
Usage

Signs in by pasting a personal access token from your account at agentfacets.io. Requires a terminal. The token is verified against the registry before it is saved, so a typo or expired token fails immediately and you are reprompted.

​
Exit codes

​
Details

​
Where the credential is stored

The verified token is written to the credentials file with mode 0600:

​
Token precedence

FACET_TOKEN takes precedence over the saved file. facet login says so when both are present, so the variable cannot silently shadow what you just saved.

​
Troubleshooting

Cause: a command that needs the registry found neither FACET_TOKEN nor a saved credentials file.Fix:
Cause: the credentials file exists but is unreadable or malformed. This is a different failure from having no credential at all.Fix: run facet login again to rewrite the file, or set FACET_TOKEN for the current shell.
Cause: the registry refused the pasted token, usually because it was revoked, expired, or copied incompletely.Fix: mint a new token in your account settings and paste it again.

​
See also