Skip to main content
A service profile is a bot identity that agents run under when they operate on behalf of the org rather than a specific developer. Instead of using your GitHub token and Claude key, the agent authenticates with the profile’s credentials and commits as a bot author.

​
When to use a service profile

Developer-spawned agents use your GitHub token, Claude subscription, and git identity. That works for interactive tasks. Automated agents, including event-triggered flights, scheduled tasks, and merge-queue processors, need an identity that doesn’t belong to any individual. A service profile provides:
  • Bot git identity: commits show the GitHub App’s bot avatar, not a developer’s
  • Org-scoped credentials: an Anthropic API key owned by the team, not an individual
  • Access grants: control who can spawn agents with this profile

​
What a service profile contains

​
Using a service profile

From the dashboard: the spawn dialog shows an identity picker. Select the profile instead of your personal identity. From flights: set service_profile in the flight frontmatter. Every agent the flight launches inherits the profile’s identity. From the CLI: pass --service-profile on murmur spawn. By default for every spawn: set service_profile in murmur.yaml (or its murmur.local.yaml overlay). Every CLI and MCP spawn that does not name a profile explicitly borrows this one. Precedence is explicit value (the --service-profile flag or the MCP service_profile argument) > a flight’s frontmatter service_profile > the murmur.yaml service_profile. Leave it unset to keep the default behavior of spawning as yourself. See the service profiles guide for step-by-step setup from the dashboard.