vexy-overnight¶
vexy-overnight starts AI coding assistants (Claude Code, Codex and Gemini CLI) with fixed flags, and can hand a session that has just finished over to the next assistant, so that work continues without you typing the next command. It also keeps the instruction files those tools read (CLAUDE.md, AGENTS.md, GEMINI.md and others) identical across a project.
The package installs five commands:
| Command | Purpose |
|---|---|
vomgr |
Install the continuation hooks, switch them on and off, set preferences, sync instruction files, update the CLIs |
vocl |
Start Claude Code |
voco |
Start Codex |
voge |
Start Gemini CLI |
version-bump |
Tag the next patch version in a git repository and push it |
How continuation works, in one example¶
You have run vomgr install and vomgr enable claude. You start Claude in a project:
When Claude finishes its turn and stops:
- Claude runs its
Stophook, whichvomgr enable claudepointed at~/.claude/hooks/vocl-go.py. vocl-go.pyreads your preferences from~/.vexy-overnight/settings.toml. By default, Claude hands over to Codex.- It builds a prompt from the template for Claude, filling in up to five open
- [ ]items from~/work/my-app/TODO.md. - It writes the Codex command line, the project directory and some environment variables to
~/.claude/hooks/vocl-new.json. - It runs the terminal command configured for your platform (on macOS, by default,
open -a Terminal …) and passes it a shell command that runs the helpervocl-new.py. - The helper reads the JSON file, starts Codex in
~/work/my-appwith the prompt and records the new process in~/.vexy-overnight/session_state.json. Ifpsutilis installed, it also stops the assistant process recorded there before.
Codex's notify hook works the same way and, by default, hands back to Claude.
The details are in How continuation works.
The assistants run without confirmations
vocl, voco, voge and the continuation commands start the assistants with their permission and sandbox checks turned off (--dangerously-skip-permissions, --dangerously-bypass-approvals-and-sandbox --sandbox danger-full-access, -y). The assistant can then run any command and change any file without asking. Use them only in projects and on machines where that is acceptable.
Where to go next¶
| If you want to… | Read |
|---|---|
| Install the package | Installation |
| Set up continuation from Claude to Codex | Quick start |
Look up a vomgr command |
vomgr reference |
| Start an assistant directly, or tag a release | Launchers and version-bump |
| Understand hooks, helper scripts and session handover | How continuation works |
| Change targets, prompts, notifications or terminals | Configuration |
Keep CLAUDE.md, AGENTS.md and friends in sync |
Instruction files |
| Fix a problem | Troubleshooting |
| Work on the code | Development |