> ## Documentation Index
> Fetch the complete documentation index at: https://inkbox.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hosted agents

> Run a Hermes or Codex agent for an Inkbox identity on its own computer.

Inkbox can host an agent for any identity. Choose Hermes or Codex, a computer size, and a default model with the [hosting API](https://inkbox.ai/docs/api/identities/hosting.md). The agent uses the identity's email, phone, and other channels.

Your identity's channels keep working whether you host the agent with Inkbox or elsewhere.

## Talk to the agent

Use the [chat API](https://inkbox.ai/docs/api/identities/chat.md) to send messages, approve tool requests, and answer questions. Conversations started by incoming messages and schedules are readable there too.

Each chat has a permission mode. **Ask** asks before using tools. **YOLO** approves tool requests automatically. Incoming communications and scheduled runs approve automatically. Contact rules, data access, and quotas apply in every mode, and the agent can't edit its own contact rules.

## Computer

**Stop** ends running programs and keeps files, conversations, and schedules. The computer also stops after its idle timeout.

Selected incoming events and enabled schedules start the computer again, even after a manual stop. To prevent automatic starts, clear `trigger_events` and pause schedules.

Open a terminal for a Bash shell on the computer. Run `codex` or `hermes` there for the agent's own interface. Environment variables apply to new processes, and `TZ` defaults to `UTC`.

## Schedules

Ask the agent to create a schedule, or manage schedules with the [workspace API](https://inkbox.ai/docs/api/identities/chat.md#schedules). A run can start up to 15 minutes late. Pausing works while the computer is off.

## Instructions and connections

Hosted-agent instructions are separate from voice-agent instructions. The hosted agent shares the identity's MCP connections with the voice agent. Live calls use the voice agent, and a completed call can trigger follow-up work by the hosted agent.

## Remove hosting

Removing hosting permanently deletes the computer and its files. The identity, its channels, voice settings, MCP connections, and webhooks remain.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.