Low Cafeine

Repo-local Codex workflow installer.

low-cafeine installs this repository's Codex skills, rules, and workflow kits into the project repo you are currently working in. It is meant for moving between computers without setting up global ~/.codex state.

Quick Start

Run this inside the target project repo:

npx low-cafeine init

That creates or updates:

.codex/
  kits/
  rules/
  skills/

After that, open or restart Codex in that project repo and ask for a workflow by name:

production-feature-dev로 이 화면 구현해줘

prototype-to-prod로 이 프로토타입을 실제 컴포넌트로 바꿔줘

What Gets Installed

Default runtime skills:

• production-feature-dev
• prototype-to-prod

Shared assets:

• .codex/kits: reusable workflow/template building blocks
• .codex/rules: hard workflow rules

Maintainer/generator skills such as ooo-templates are not installed by default.

Commands

npx low-cafeine init
npx low-cafeine update
npx low-cafeine list

init installs assets without overwriting changed existing files. Use it when adding workflows to a project for the first time.

update overwrites changed installed files with the package version. Use it when refreshing a project from a newer release.

list shows packaged skills and shared assets.

Options

Install one skill:

npx low-cafeine init --skills production-feature-dev

Install all packaged skills:

npx low-cafeine init --skills all

Install maintainer/generator skills too:

npx low-cafeine init --include-maintainer

Preview without writing:

npx low-cafeine init --dry-run

Overwrite existing changed files during init:

npx low-cafeine init --force

Install into another project directory:

npx low-cafeine init --target /path/to/project

Skip shared kits or rules:

npx low-cafeine init --no-kits
npx low-cafeine init --no-rules

Repository Layout

.codex/
  kits/     reusable workflow/template sources
  rules/    hard rules copied into target repos
  skills/   runnable Codex skills copied into target repos

bin/
  codex-workflows.js

kits are source templates. skills are the materialized packages Codex can trigger from a target repo.

Release

Before publishing, make sure no token file is present:

test ! -f .npmrc

Check package contents:

npm pack --dry-run

Publish a new version:

npm pkg set version=0.1.3
npm publish --access public

Never commit .npmrc or an npm token.