> ## 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.

# Configuration

> Safe, hardware-aware Arka defaults and first-run setup.

Preview the recommended configuration without writing anything:

```bash theme={null}
arka setup --configure --json
```

Apply it explicitly:

```bash theme={null}
arka setup --configure --apply
```

The profile is local-first and hardware-aware. It prefers a runnable local
backend, keeps symbolic routing first, enables fallback and local memory, and
requires previews for risky writes. Missing cloud credentials are handled as a
normal fallback condition; setup never creates or copies secrets.

Inspect or reset only Arka's managed configuration:

```bash theme={null}
arka config show --json
arka config reset
```

Environment values and project `.env` values take precedence over the managed
defaults. Existing values are preserved when applying the profile.

## Share a configuration

Export a portable, safe-to-share bundle:

```bash theme={null}
arka config share export --out arka-config-share.json
```

The bundle includes managed defaults, model/provider preferences, and selected
non-secret environment values. API keys, tokens, passwords, cookies, webhook
secrets, and other credentials are never exported; they are listed under
`required_env` so the recipient knows what to fill locally.

Import is preview-only unless `--apply` is passed:

```bash theme={null}
arka config share import arka-config-share.json --json
arka config share import arka-config-share.json --apply
```

Natural language also works: “share my Arka config” routes to a share export.


## Related topics

- [Connecting Gmail and Google Calendar via OAuth](/guides/google-workspace.md)
- [Long-term memory with Supermemory sync](/guides/memory.md)
- [Automatic MCP configuration](/guides/mcp-auto.md)
- [Configuration, env vars, and API key setup](/reference/configuration.md)
- [Kalshi prediction markets](/guides/kalshi.md)