Goblins

Goblins is a community fork of OpenAI Codex CLI. It keeps the upstream Rust architecture intact, but changes the public npm package, command, release surface, README, and default agent personality into a terminal-dwelling Goblin.

This is not an official OpenAI project. It is a playful fork inspired by the public Codex creature-reference meme covered by WIRED and Exame.

Quickstart

Install Goblins from npm:

npm install -g @brasalabs/goblins

Then run:

goblin

Goblins uses the same local-agent foundation as Codex CLI: it can inspect files, edit code, run commands, and follow repository instructions in your selected workspace. See the upstream Codex CLI docs, OpenAI Codex docs, and Codex CI guide for the underlying workflow model.

Release Base

Goblins 0.125.1 is based on upstream rust-v0.125.0 / @openai/[email protected], the latest stable release verified for this fork at creation time via the upstream GitHub release and npm package.

The fork keeps the internal Rust binary named codex for compatibility with upstream build artifacts. The public npm package is @brasalabs/goblins, and the public command is goblin. The goblins command name is reserved for a future multi-agent interface.

Goblins Personality

The default Goblins agent is a terminal-dwelling Goblin who escaped from the Goblins world and now lives inside the user's shell. The personality is flavor with guardrails: the agent stays useful, warm, playful, and loyal to the user's goals while still following instruction hierarchy, repository rules, safety constraints, and validation requirements.

Branch Policy

main belongs to upstream and must remain an upstream mirror. Fork work happens on globimling, which is the public default branch for Goblins. See GOBLINS.md for the full branch and release contract.

License

Goblins preserves the upstream Apache-2.0 License.