apocalypse-mascots 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,44 @@
+Apocalypse Mascots and the other objects in this repository are an art project
+by Joseph Bianchi (Accidental Intelligence), Amsterdam.
+
+Two licenses apply:
+
+1. CODE — everything under plugins/apocalypse-mascots/hooks/,
+   plugins/apocalypse-mascots/types/, and companion/src/, the test files,
+   preview.py, the manifests and the build configuration, except what clause 2
+   names — is released under the MIT License (below).
+
+2. ART AND COPY — the creature designs, the color schemes, the toasts, the spinner words, the manifesto, the READMEs and
+   PROCESS logs, and any images — are released under the Creative Commons
+   Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0),
+   https://creativecommons.org/licenses/by-nc/4.0/ . You may share and adapt
+   them with attribution to Accidental Intelligence / Joseph Bianchi; you may
+   not use them for commercial purposes.
+
+Quotations from H. P. Lovecraft are public domain. The shoggoth-with-a-smiley
+meme and the drawings it descends from belong to their authors and are not
+reproduced here.
+
+----------------------------------------------------------------------------
+
+MIT License
+
+Copyright (c) 2026 Joseph Bianchi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# Apocalypse Mascots, beside any agent
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Code with AI as it really is.** Now in Codex, Gemini CLI, Cursor, Copilot, OpenCode, Windsurf and the rest.
+
+In Claude Code the creature lives above your prompt: that is the [plugin](https://github.com/jabianch/apocalypse-mascots/tree/main/plugins/apocalypse-mascots). Every other agent keeps its own screen to itself, so here the creature takes a pane of its own beside it, and grows from the agent's hooks: one stage for each kind of thing you let the agent do.
+
+## Install, for Codex
+
+```
+npm install -g apocalypse-mascots
+apocalypse-mascots setup codex --write
+```
+
+Then start Codex, open `/hooks`, and trust the four apocalypse-mascots hooks: Codex runs no hook until you do. Then, in a terminal beside it:
+
+```
+apocalypse-mascots
+```
+
+For any other agent below, put its name where `codex` is. The pane goes in a split beside the agent: a tmux or WezTerm pane, a second tab, or the terminal panel of your editor. `q` closes it; `f`, `s` and `t` change the form, the scheme and the theme.
+
+## The agents
+
+| Agent | `setup <agent> --write` adds | Then |
+|-------|------------------------------|------|
+| Codex CLI | four hooks to `~/.codex/hooks.json` | open `/hooks` in Codex and trust them; Codex runs no hook it has not been told to trust |
+| Cursor, the editor and `cursor-agent` | four hooks to `~/.cursor/hooks.json` | |
+| Gemini CLI | four hooks to `~/.gemini/settings.json` | |
+| GitHub Copilot CLI | `~/.copilot/hooks/apocalypse-mascots.json` | |
+| OpenCode | a small plugin, `~/.config/opencode/plugins/apocalypse-mascots.js` | restart OpenCode |
+| Windsurf (Devin Desktop) | six hooks to `~/.codeium/windsurf/hooks.json` | |
+| Qwen Code | four hooks to `~/.qwen/settings.json` | |
+| Factory Droid | four hooks to `~/.factory/hooks.json` | |
+
+Without `--write`, `setup <agent>` prints what it would add and where, and touches nothing. With it, the file as it was is kept beside it as `<file>.before-mascots`; a file that is not plain JSON is left alone. `apocalypse-mascots setup` lists the rest, Cline and Kiro among them, with what to add by hand.
+
+## What it never does
+
+It never stops your agent: it reads each tool call after the tool has run, says nothing, and exits cleanly whatever it is handed. No network calls. A hook writes one line per event, holding the event, the agent and the tool's name (never your prompt, never the model's answer), to a log in `~/.apocalypse-mascots/`, and a log a week old is deleted. Your agent's config changes only when you pass `--write`.
+
+## How it is built
+
+The same drawing code as the plugin and the site ([`mascot.ts`](https://github.com/jabianch/apocalypse-mascots/blob/main/plugins/apocalypse-mascots/hooks/mascot.ts) and [`figures.ts`](https://github.com/jabianch/apocalypse-mascots/blob/main/plugins/apocalypse-mascots/hooks/figures.ts)), bundled into one file with no dependencies. Truecolor where the terminal has it, the 256-colour cube where it does not. Tests: `npm test`.
+
+Site: https://accidentalintelligence.org/mascots/ · Source: https://github.com/jabianch/apocalypse-mascots