AgentKit
DocsKitsCLI ReferenceDesktop App
BetaYou are reading docs for the beta channel (3.0.0-beta.41). Features may change before the next stable release.Switch to stable →

alias

ak secrets alias unset

Remove an alias; the secret it pointed at is untouched.

Use ak secrets alias unset to drop an alias name. Only the mapping goes away: the stored secret it pointed at keeps its value and its grants.

Usage

ak secrets alias unset <NAME>

Exactly one argument is required. The command has no flags of its own. It writes ~/.agentkit/secrets/aliases.json and never touches a value.

Output

Human stdout prints removed NAME (was REF).

JSON success uses:

schema_version: 1
kind: secrets.alias
data.action: unset
data.aliases[]: name, ref, updatedAt

data.aliases holds the one removed alias with the ref it pointed at.

Exit behavior

ExitMeaning
0Success.
2Invalid flags or arguments, or an invalid row in the aliases file.
3No such alias.
5The aliases file could not be read or written.