Beta Coming soon. This feature is still being built, so names and details may change before it ships.

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, bin and react-native from each package.json (a built path like dist/index.js is shown as its source file, wherever it lives), and files named index, main, app, server or cli next 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), tsconfig paths aliases (@/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.

SettingDefaultEffect
ingot.agent.repoMap.enabledtruegive the agent the map
ingot.agent.repoMap.tokenBudget2000most tokens the map takes (fewer key files first, then names only)

The map follows the same ignore files as Codebase search.