Skip to content
Perseus logo

Perseus

Verified

Live workspace context engine that loads AGENTS.md for AI agents at session start.

Autonomous AgentsGeneral-Purpose 17Open source
View on GitHub
Updated 2026-06-15
Perseus GitHub repository

What is Perseus?

Perseus is an open-source live workspace context engine built to support AI agents during coding and development tasks. It focuses on delivering essential project instructions without manual intervention.

The engine works by rendering an AGENTS.md file automatically whenever a new agent session begins. This provides immediate access to workspace-specific guidance across supported platforms.

It is intended for developers and teams who rely on AI coding assistants and want reliable context handling in tools like Claude Code, Codex, and Hermes.

What you can build with Perseus

Session Startup

Automatically supplies workspace instructions to agents the moment a session launches.

Multi-Tool Integration

Extends context support across Claude Code, Codex, and Hermes environments.

Project Onboarding

Helps agents understand repository guidelines through a single AGENTS.md source.

Install Perseus

Quick start
curl -sSL https://raw.githubusercontent.com/tcconnally/mimir/main/scripts/bootstrap.sh | bash
  1. 1Add an AGENTS.md file to your workspace root.
  2. 2Install the Perseus plug-in for a supported AI tool.
  3. 3Configure the integration in Claude Code, Codex, or Hermes.
  4. 4Launch a new agent session to trigger context rendering.
  5. 5Verify that instructions from AGENTS.md appear at startup.

Perseus: pros & cons

Pros

  • +Open-source and freely available
  • +Automatic context loading at session start
  • +Works with multiple popular AI coding tools
  • +Simple reliance on standard AGENTS.md format

Cons

  • Limited to three specific platforms
  • Requires manual creation of AGENTS.md
  • No built-in command or installation details provided
Did you find this helpful?

Frequently asked questions

It integrates as a plug-in with Claude Code, Codex, and Hermes.

User reviews

Verified reviews from the community shape this listing's rating.

Loading reviews…

Sign in to review

Promote Perseus

Add this badge to your website, or share the tool.

DFeatured on DhanasviPerseus 0