Skip to content

aspens save-tokens

Install token-saving session management for Claude Code. Prevents context bloat, enables session rotation, and tracks token usage.

Terminal window
npx aspens save-tokens [path]
Terminal window
npx aspens save-tokens --recommended

No prompts — installs everything with sensible defaults.

  • Token tracking hooks (prompt + post-tool-use)
  • Statusline showing token usage
  • Warning prompts when approaching context limits
  • Slash commands for session compaction and handoff
Terminal window
npx aspens save-tokens --remove

Removes all save-tokens files, settings entries, and configuration.

OptionDescription
--recommendedInstall with defaults, no prompts
--removeUninstall save-tokens files and settings

See the Save Tokens guide for more details.