Skip to content

Configuration

Multi can be configured at three different layers, each with a clear purpose:

FeatureScopePurpose
PersonasGlobal (user)Identity and communication style
AGENTS.mdWorkspaceProject-specific build, test, style, and workflow instructions
SkillsWorkspace or userReusable, activatable workflows loaded on demand

Customize Multi’s personality and communication style with Personas. Personas live in ~/.multi/soul/ and affect how Multi expresses itself - not its capabilities or available tools.

Manage personas from the Multi panel → Settings (gear icon) → Personas. See the Personas guide for details.

For project-specific instructions - build commands, code style, testing conventions, and other context Multi needs to work effectively in a repository - add an AGENTS.md file at the root of your project.

Multi loads a single AGENTS.md from the workspace root - there’s no global override and nested files are not traversed.

See the AGENTS.md reference for details and examples.

For focused, reusable workflows you want Multi to activate on demand - code reviews, refactoring playbooks, deployment checklists, team conventions - use Skills.

Skills live in .multi/skills/ or .agents/skills/ (project) or ~/.multi/skills/ or ~/.agents/skills/ (user) and are loaded into the agent context when activated. See the Skills guide to learn how to create one.