Skip to content

Ready to be public and open to contributors; CI on Linux and macOS with manifest validation - #3

Merged
parintorns merged 2 commits into
mainfrom
public-docs
Sep 30, 2026
Merged

parintorns merged 2 commits into
mainfrom
public-docs

Conversation

@parintorns

Copy link
Copy Markdown
Contributor

What changes

Prepares the repository to be made public and open to contributors. No change to the plugin's behaviour: scripts/mailbox.py changes only in prose (a docstring and the text it gives the session, where the name is now written "Animus").

  • File format in this repository. docs/agent-mailbox.md describes the mailbox format the plugin shares with Animus: the mailbox, the pointer, sending, the message format, and what Animus does with a message. The README, the skill and the script point to it.
  • README for people who already run Animus: what the plugin does, install and a check, use, what it writes and reads (~/.agent-mailbox pointers, the mailbox in the plugin's data folder, the first line of the last reply read from the transcript), uninstall, development, contributing and license.
  • LICENSE (MIT) and SECURITY.md (private reporting; what the plugin touches, with prompt injection through an inbox message in scope).
  • Contributors: CONTRIBUTING.md, CODE_OF_CONDUCT.md (Contributor Covenant 2.1), .github/CODEOWNERS, issue templates (bug, feature; blank issues off; security goes to private advisories) and a pull request template.
  • Naming: "Animus" in all prose; identifiers keep lowercase (animus-mailbox, ANIMUS_AGENTS_DIR, from: animus).
  • CI: the unit tests run on ubuntu-latest and macos-latest (the plugin runs on the Mac and walks the process tree with ps). A new validate job installs Claude Code and runs claude plugin validate --strict on the marketplace, plugin.json and skills. marketplace.json gains the description the strict check asks for.

The required status checks on main move from test to test (ubuntu-latest), test (macos-latest) and validate.

Checks

  • python3 -m unittest discover -s tests: 18 OK locally (macOS).
  • claude plugin validate --strict on ., .claude-plugin/plugin.json and skills: passed locally.

🤖 Generated with Claude Code

parintorns and others added 2 commits October 1, 2026 04:37
The file format the plugin shares with Animus is written out in docs/agent-mailbox.md, and the
README, the skill and the script point there. The README opens as add-ons for people who already
run Animus (Claude Code for now) and says what the plugin writes and reads, how to check, use and
uninstall it, and how to try a change. LICENSE is MIT. SECURITY.md says how to report and what the
plugin touches, including that a message in the inbox reaches the agent. CONTRIBUTING, a code of
conduct, CODEOWNERS and issue and pull request templates open it to contributors. The name is
written Animus in all prose.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
The plugin runs on the Mac, and it walks the process tree with ps, so the tests run on macOS as
well as Linux. A validate job runs claude plugin validate --strict on the marketplace, the plugin
and the skill; the marketplace gains the description that check asks for.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@endgame-code-triage endgame-code-triage Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed at 8da182ce. I read the full files: all 18 changed files (both old and new versions for modified files), plus hooks/hooks.json.

I traced the code paths in scripts/mailbox.py — all changes are capitalization of "animus" → "Animus" in string constants and user-facing strings, with identifiers kept lowercase per the stated convention. I verified the naming consistency repo-wide via grep. I confirmed the marketplace.json description field has no code consumers beyond the validation tool. I checked that the test string changes in test_mailbox.py align with the startswith("<task-notification" guard in mailbox.py (it doesn't inspect tag content).

Confidence: 90/100 because every change is documentation, community files, CI configuration, or branding capitalization with no behavioral or correctness impact.

There are no review comments to provide on this diff.

@parintorns
parintorns merged commit 03b4147 into main Sep 30, 2026
3 checks passed
@parintorns
parintorns deleted the public-docs branch September 30, 2026 22:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant