keep-codex-fast
v0.1.0
Published
Codex desktop maintenance skill, automation, and CLI for keeping local sessions, logs, config, and worktrees boring.
Maintainers
Readme
keep-codex-fast
Codex desktop maintenance as a CLI, Codex skill, automation template, and script.
It audits local Codex sessions, archived sessions, worktrees, config, state databases, logs, skills, plugins, memories, and automations. Cleanup is conservative: it backs up first, refuses mutation while Codex is running, never kills processes, and skips git worktree moves unless explicitly requested.
Install
npm i -g keep-codex-fast
keep-codex-fast setupThen run audits or cleanup:
keep-codex-fast audit
keep-codex-fast applyFor manual cleanup, quit Codex first, then run:
keep-codex-fast apply --days 10 --worktree-days 14 --log-max-mb 250Install the Skill with Skills CLI
After this repo is public on GitHub:
npx skills add k0nkupa/keep-codex-fast --skill keep-codex-fast -g -y --copyThe skill lives at:
skills/keep-codex-fast/SKILL.mdHomebrew
During development:
brew install --HEAD ./Formula/keep-codex-fast.rbFor public Homebrew installs, create a separate tap repository named k0nkupa/homebrew-keep-codex-fast, copy Formula/keep-codex-fast.rb into that tap, publish a GitHub release, update the formula URL/SHA, then users can run:
brew tap k0nkupa/keep-codex-fast
brew install keep-codex-fast
keep-codex-fast setupWithout a tap repo, users can still install directly from the formula URL or local checkout.
Commands
keep-codex-fast setup # install skill and weekly automation into ~/.codex
keep-codex-fast audit # run report-only maintenance
keep-codex-fast apply # run cleanup; script refuses while Codex is open
keep-codex-fast doctor # show install/runtime checksDevelopment
npm test
npm run check
npm run pack:dry