> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# Hosted mode

> Keep desktop-only Arka skills out of server deployments.

Arka automatically detects common hosted environments and disables skills that
need a local desktop, audio device, or GUI. This includes music playback,
desktop browser automation, microphone/wake-word capture, and screen controls.
Coding, API, data, media conversion, and server-safe image skills remain
available.

Inspect the effective profile:

```bash theme={null}
arka skills status
```

Force a profile with environment configuration:

```bash theme={null}
ARKA_HOSTED_MODE=1 arka skills status  # hosted
ARKA_HOSTED_MODE=0 arka skills status  # desktop
```

Or persist it for a deployment:

```bash theme={null}
arka skills profile hosted --apply
```

The default is `auto`. Detection considers CI, containers, headless Linux, and
missing audio devices. To restore one profile-disabled skill, run
`arka skills enable <skill>`; the override is stored separately from the
user-disabled list. This is useful for Railway, Render, Hugging Face, Docker,
and other server deployments.


## Related topics

- [Deploy coding skills to Railway](/guides/railway-coding-skills.md)
- [Installing and building Arka plugins](/guides/plugins.md)
- [Integrations](/guides/integrations.md)
- [MCP integration for Cursor and Claude](/guides/mcp.md)
- [Easy AI model hosting setup](/guides/model-hosting.md)