Linked Projects

Link additional project directories to give the agent access to multiple codebases in a single session.

Adding a linked project

1. Open the commands menu with / or Ctrl+P
2. Select Link Project
3. Enter the path to the project directory
4. Choose the scope:
   • Session — access lasts until you exit
   • Permanent — saved and restored in future sessions

Once linked, the agent can read and search files across all linked projects. Tools like grep and filename_search accept a directory parameter to target a specific linked project.

When to use linked projects

Use linked projects when:

• a change spans multiple local repositories
• you need the agent to inspect shared libraries alongside an app
• you want one session to reason across related codebases

See Also

• Session History — Sessions can be resumed later with their broader context
• Memory — Persist project-specific knowledge across work