# brainjar

> Shape how your AI thinks — composable soul, persona, and rules for AI agents.

brainjar manages AI agent behavior through composable layers. Instead of one monolithic config file, you separate what the agent sounds like (soul), how it works (persona), and what constraints it follows (rules). Each layer is a markdown document managed on the brainjar server. The CLI is a thin client.

## Quick start

```bash
npm install -g @brainjar/cli
brainjar init --default
brainjar status
```

## Docs

Every page is available as raw markdown by appending `.md` to the URL path.
For example: `https://brainjar.sh/getting-started.md`

- [Getting Started](https://brainjar.sh/getting-started.md)
- [Core Concepts](https://brainjar.sh/concepts/overview.md)
  - [Why Composable Prompts](https://brainjar.sh/concepts/why-composable.md)
  - [Architecture](https://brainjar.sh/concepts/architecture.md)
  - [Souls](https://brainjar.sh/concepts/souls.md)
  - [Personas](https://brainjar.sh/concepts/personas.md)
  - [Rules](https://brainjar.sh/concepts/rules.md)
  - [Brains](https://brainjar.sh/concepts/brains.md)
- [Configuration](https://brainjar.sh/guides/configuration.md)
- [MCP Integration](https://brainjar.sh/guides/mcp.md)
- [Migrating from Monolithic Prompts](https://brainjar.sh/guides/migration.md)
- [Subagent Orchestration](https://brainjar.sh/guides/subagents.md)
- [Orchestration Patterns](https://brainjar.sh/guides/orchestration-patterns.md)
- [Packs](https://brainjar.sh/guides/packs.md)
- [Hooks](https://brainjar.sh/guides/hooks.md)
- [Authoring with AI](https://brainjar.sh/guides/authoring-with-ai.md)
- [Recipes](https://brainjar.sh/guides/recipes.md)
- [CLI Reference](https://brainjar.sh/reference/cli.md)

## Links

- Docs: https://brainjar.sh
- GitHub: https://github.com/brainjar-sh/cli
- npm: https://www.npmjs.com/package/@brainjar/cli