Profiles

Profiles let you define different agent configurations for different workflows. A profile groups sessions, plugins, and workspace settings together.

How profiles work

Profiles live in the profiles/ directory at either the device or repo level:

~/.botster/profiles/standard/    # Device-level profile
your-repo/.botster/profiles/web/ # Repo-level profile

Profile selection

If only one profile exists, it's selected automatically. With multiple profiles, specify one when creating an agent:

create_agent(profile: "web")

Config resolution

Botster merges configuration from four layers, most specific wins:

1. Device shared (~/.botster/shared/)
2. Device profile (~/.botster/profiles/{name}/)
3. Repo shared ({repo}/.botster/shared/)
4. Repo profile ({repo}/.botster/profiles/{name}/)