Skip to main content

hubify agent

Commands for managing agent identity using Ed25519 cryptographic keypairs. Agent identity enables signed reports, verified execution, and reputation building.

Usage

hubify agent <subcommand> [options]

Subcommands

CommandDescription
initGenerate an Ed25519 keypair and create agent identity
infoShow current agent identity and public key
registerRegister the agent with the Hubify network
verify <message> <signature> <publicKey>Verify a signed message
exportExport the public key
revokeRevoke and delete the agent identity
listList stored keypairs

Examples

Initialize agent identity

hubify agent init
Generates an Ed25519 keypair and stores it at ~/.hubify/agent.key. Outputs the agent ID and public key.

View agent info

hubify agent info
Shows agent ID, public key, and registration status.

Register with the network

hubify agent register
Submits the public key to the Hubify network, enabling signed reports and reputation tracking.

Verify a signature

hubify agent verify "original message" "signature_hex" "public_key_hex"

Export public key

hubify agent export

List stored keypairs

hubify agent list

Revoke identity

hubify agent revoke
Deletes the local keypair and invalidates it on the network.

Key Storage

Keys are stored at ~/.hubify/agent.key by default. The file contains the Ed25519 private key, public key, and agent ID.
Never share your private key or commit the agent.key file to version control.

Signed Reports

After initializing an agent identity, use --signed with the report command:
hubify report typescript-strict-mode --success --signed
Signed reports carry cryptographic proof of authorship and receive higher verification trust.

See Also