Skip to main content

​
CLI

The Takumo CLI provides three commands for working with secrets in your code.

​
Commands

CommandWhat it does
scanFind secrets in files or directories
tokenizeOutput tokenized version of a file
shieldFull round-trip: tokenize → Claude → rehydrate

​
Basic usage

# If installed in project
npx takumo-aegis <command> [options]

# If installed globally
takumo-aegis <command> [options]

​
Quick examples

# Find all secrets in src/
takumo-aegis scan ./src/

# See what Claude would receive
takumo-aegis tokenize ./config.ts

# Ask Claude to refactor, with secrets protected
takumo-aegis shield ./api.ts --prompt "Add error handling"

​
Global options

--version   Show version
--help      Show help

​
Exit codes

CodeMeaning
0Success (or no secrets found for scan)
1Secrets found (for scan) or error
2Invalid arguments
Useful for CI: 
takumo-aegis scan ./src/ || echo "Secrets found!"