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

# Repo map

> Lightweight project layout and Python symbol overview for agent context.

Get a compact view of the current git repo — directory layout, detected project type, and top-level Python symbols. Inspired by Aider/OpenCode repo-awareness, without full RAG ingest.

## Natural language

```bash theme={null}
arka map this repo
arka show project structure
arka codebase overview with symbols
```

## CLI commands

| Command                  | Description                         |
| ------------------------ | ----------------------------------- |
| `repo_map map [path]`    | Show layout (depth 2)               |
| `repo_map map --depth 3` | Deeper tree                         |
| `repo_map map --symbols` | Include Python class/function names |

Uses the current git root when inside a repository, otherwise the current directory. Ignores `node_modules`, `.git`, virtualenvs, and build artifacts.


## Related topics

- [How to code with Arka](/guides/code-with-arka.md)
- [MCP integration for Cursor and Claude](/guides/mcp.md)
- [Deploy coding skills to Railway](/guides/railway-coding-skills.md)
- [Arka — AI terminal agent documentation](/index.md)
- [Repo health](/guides/repo-health.md)