Project map
At the start of every task Ingot gives the agent a short, ranked overview of the open project, so it finds the right files sooner and reads fewer of them. It works for any layout: one package, a monorepo, a mobile app without a src folder, or several projects side by side.
Project map (ranked overview of the open project; read files with ingot/read_file before changing them):
Project: acme (1,284 files; TypeScript 902, Swift 41, Kotlin 38)
Frameworks: Turborepo, Next.js, React, React Native, Expo
Packages: apps/web/ (Next.js, React), apps/mobile/ (React, React Native, Expo), packages/ui/ "@acme/ui" (React)
Entry points: apps/mobile/index.js, packages/ui/source/index.ts, apps/web/app/page.tsx
Commands: dev: `pnpm run dev`; test: `pnpm run test`
Key files (most imported first):
- packages/ui/source/index.ts ← 14 file(s): Button, Card, Sheet
What it contains
- Packages: every folder with a manifest (
package.json,pyproject.toml,go.mod,Cargo.toml,pubspec.yaml, Gradle, Podfile, .csproj), with its frameworks. Examples and test fixtures are left out. - Entry points:
main,module,binandreact-nativefrom eachpackage.json(a built path likedist/index.jsis shown as its source file, wherever it lives), and files namedindex,main,app,serverorclinext to a manifest or one folder below it, whatever that folder is called. - Commands: the root scripts with your package manager; a project with no root manifest gets the commands of its main package, run in its folder.
- Key files: ranked by how many files import them. Imports are followed through relative paths, workspace package names (
@acme/ui), tsconfigpathsaliases (@/components) and Python modules under any folder.
Use it
Run Ingot: Show Project Map to open the map the agent gets. It is rebuilt a few seconds after files change.
| Setting | Default | Effect |
|---|---|---|
ingot.agent.repoMap.enabled | true | give the agent the map |
ingot.agent.repoMap.tokenBudget | 2000 | most tokens the map takes (fewer key files first, then names only) |
The map follows the same ignore files as Codebase search.