Daimyo - Rules Server for Agents¶
Daimyo (大名) is an extensible Python server providing rules and project vision (Tenka) to AI agents through REST and MCP interfaces. Supports scope-based rules with inheritance, categories for filtering, and server federation for distributed rule management.
Features¶
- Multiple Interfaces: REST API, MCP (Model Context Protocol), and CLI
- Scope Inheritance: Single and multiple parent inheritance with priority-based conflict resolution
- Rule Types: Commandments (MUST) and Suggestions (SHOULD)
- Tenka (天下): Model the project vision ("everything under the sky") with User Stories and Acceptance Criteria, and track fulfillment status
- Categories: Organize rules into hierarchical categories for selective retrieval
- Server Federation: Distribute scopes across multiple servers with automatic merging
- Multiple Formats: Output as YAML, JSON, or Markdown
- Clean Architecture: Domain-driven design with clear separation of concerns
- Templating System: Rules can use Jinja2 templates to be defined as generic rules that change their form depending on the context
- Extensibility via Plugins: Plugins can extend the features of daimyo instances
- Configurable Markdown Formatting: Prologues/epilogues, XML tag wrapping, and aggregated display modes
- Authentication: OAuth2/OIDC login (PKCE and device flow), secure token storage, and scope-level access control via JWT role claims
Quick Start¶
1. Set Up Your Rules¶
2. Start the Server¶
3. Access the API¶
Visit http://localhost:8000/docs for interactive API documentation.