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

# 仓库地图

> 为 Agent 上下文提供的轻量级项目布局和 Python 符号概览。

获取当前 git 仓库的紧凑视图 —— 目录布局、检测到的项目类型以及顶层 Python 符号。灵感来自 Aider/OpenCode 的仓库感知，但无需完整的 RAG 摄取。

## 自然语言

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

## CLI 命令

| 命令                       | 描述               |
| ------------------------ | ---------------- |
| `repo_map map [path]`    | 显示布局（深度 2）       |
| `repo_map map --depth 3` | 更深的目录树           |
| `repo_map map --symbols` | 包含 Python 类/函数名称 |

在仓库内时使用当前 git 根目录，否则使用当前目录。忽略 `node_modules`、`.git`、虚拟环境和构建产物。


## Related topics

- [仓库健康度](/cn/guides/repo-health.md)
- [Arka 简介](/cn/index.md)
- [Arka 故障排查：LLM、路由、语音与 RAG 修复](/cn/reference/troubleshooting.md)
- [Arka CLI 命令与参数参考](/cn/guides/cli.md)
- [如何用 Arka 写代码](/cn/guides/code-with-arka.md)