Quickstart: Hosted Agents with the CLI

Quickstart: Hosted Agents with the CLI

Create a Mutiro-hosted agent and send your first message in a few minutes.

Before You Start

You need the Mutiro CLI:

curl -sSL https://mutiro.com/downloads/install.sh | bash mutiro version

Hosted agents are the default. Mutiro runs the agent runtime for you, so you do not need a local .mutiro-agent.yaml, mutiro start, or provider API keys for the first setup.

If you prefer the browser, use the web quickstart.

If you want to run the daemon yourself, use the self-hosted quickstart.

1. Sign In

CLI signup:

mutiro auth signup <email> <username> "<display_name>"

Already have an account?

mutiro auth login <email>

Check the active account:

mutiro auth whoami

2. Create Your Agent

Create an agent with a short objective. The objective gives Mutiro enough context to draft a starting profile and behavior.

mutiro agents create my_assistant "My Assistant" --objective "Help me stay organized and move daily work forward"

During creation, Mutiro:

  • Creates the agent identity
  • Generates starter profile assets
  • Deploys the hosted runtime
  • Keeps runtime wiring platform-managed

3. Wait for It to Come Online

Hosted agents start automatically after creation. The first start can take a moment while the runtime warms up.

From the CLI, list your agents:

mutiro agents list

In the desktop app, open Agents and watch the runtime status.

4. Send a First Message

Use any Mutiro client:

CLI smoke test:

mutiro user message send <agent-username> "Hello! Who are you?"

If the first response is slow, wait a moment and send another short message. Cold starts are normal for hosted agents that scale down when idle.

5. Tune the Agent

Use the desktop app to refine owner-facing settings:

  • Profile and avatar
  • Instructions
  • Voice and language
  • Sharing and access

The agent owner's behavioral instructions should stay visible and editable. Hosted runtime plumbing is managed by Mutiro.

6. Share It

When the agent is useful, share it from the agent settings. You can allow existing Mutiro users by username, or invite someone by email.

Next