# Source: https://docs.windsurf.com/windsurf/codemaps.md

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codemaps (Beta)

> Create shareable hierarchical maps of your codebase to visualize code execution flow and component relationships. Navigate and share with teammates.

Powered by a specialized agent, Codemaps are shareable artifacts that bridge the gap between human comprehension and AI reasoning, making it possible to navigate, discuss, and modify large codebases with precision and context.

<Note>
  Codemaps is currently in Beta and subject to change in future releases.
</Note>

## What are Codemaps?

While [DeepWiki](/windsurf/deepwiki) provides symbol-level documentation, Codemaps help with codebase understanding by mapping how everything works together—showing the order in which code and files are executed and how different components relate to each other.

To navigate a Codemap, click on any node to instantly jump to that file and function. Each node in the Codemap links directly to the corresponding location in your code.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/codemaps-overview.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=e8b8990690ec210cced0f78ba1969fac" data-path="assets/windsurf/codemaps/codemaps-overview.mp4" />

## Accessing Codemaps

You can access Codemaps in one of two ways:

* **Activity Bar**: Find the Codemaps interface in the Activity Bar (left side panel)
* **Command Palette**: Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux) and search for "Focus on Codemaps View"

## Creating a Codemap

To create a new Codemap:

1. Open the Codemaps panel
2. Create a new Codemap by:
   * Selecting a suggested topic (suggestions are based on your recent navigation history)
   * Typing your own custom prompt
   * Generating from Cascade: Create new Codemaps from the bottom of a Cascade conversation
3. The Codemap agent explores your repository, identify relevant files and functions, and generate a hierarchical view

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/create-codemaps.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=ea5da928e3e72962b2bb5f2b75b659c6" data-path="assets/windsurf/codemaps/create-codemaps.mp4" />

## Sharing Codemaps

You can share Codemaps with teammates as links that can be viewed in a browser.

<Warning>
  For enterprise customers, sharing Codemaps requires opt-in because they need to be stored on our servers. By default, Codemaps are only available within your Team and require authentication to view.
</Warning>

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/share-codemaps.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=ca21fbc4275a16bef9c59026ac3b4f63" data-path="assets/windsurf/codemaps/share-codemaps.mp4" />

## Using Codemaps with Cascade

You can include Codemap information as context in your [Cascade](/windsurf/cascade) conversations by using `@-mention` to reference a Codemap.

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/K1c0U9TfuKxwshS5/assets/windsurf/codemaps/codemap-cascade.mp4?fit=max&auto=format&n=K1c0U9TfuKxwshS5&q=85&s=500ca2181f5ec83c309a3994e70499dc" data-path="assets/windsurf/codemaps/codemap-cascade.mp4" />