codex-workspace-organizer
v0.1.0
Published
Install the organizer Codex skill for small Codex-first project workspaces.
Maintainers
Readme
Codex Workspace Organizer
A small Codex skill for turning a messy or empty folder into a usable project workspace.
It creates only the basics:
AGENTS.mdas the operating contract for CodexCONTEXT.mdfor the current project stateREFERENCES.mdfor source links and filesbin/statusfor a quick local check- lightweight folders for drafts, final artifacts, references, and outputs
Optional project types add a few focused files or folders: product, research, content, course, automation, or general.
Install
After npm publish:
npx codex-workspace-organizerFrom GitHub, before npm publish:
npx github:YOUR_GITHUB_USER/codex-workspace-organizerFrom a local checkout:
./install.shOr install into a custom Codex home:
CODEX_HOME=/path/to/codex ./install.sh
npx codex-workspace-organizer --codex-home /path/to/codexThe script installs the skill at:
$CODEX_HOME/skills/organizerIf CODEX_HOME is not set, it uses ~/.codex.
Use
In Codex, from the project folder you want to organize:
$organizer
Project type: product / research / content / course / automation / general
Goal:
What already exists:
First result:For a quick manual bootstrap:
python3 ~/.codex/skills/organizer/scripts/bootstrap_codex_workspace.py . --type general --goal "Describe the project goal"
bin/statusPreview without writing files:
python3 ~/.codex/skills/organizer/scripts/bootstrap_codex_workspace.py . --type content --dry-runProject Types
| Type | Adds |
|---|---|
| product | ROADMAP.md, src/, tests/ |
| research | QUESTIONS.md, sources/, synthesis/ |
| content | SOURCE_MAP.md, drafts/scripts/, final/posts/, final/scripts/ |
| course | COURSE_MAP.md, COVERAGE.md, references/classes/, final/playbooks/ |
| automation | RUNBOOK.md, scripts/, logs/, state/ |
| general | only the core workspace files |
Verify
python3 skills/organizer/scripts/bootstrap_codex_workspace.py /tmp/organizer-smoke --type automation --goal "Run daily checks"
/tmp/organizer-smoke/bin/statusIf you have Codex's skill validator available:
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/organizerLicense
MIT
