Skip to content

User Guide

Your CodeSee map is an interactive, editable diagram that shows all of the codebase dependencies across your repository.

Exploring your map

The map begins with most folders collapsed. You can open and close a folder by clicking the toggle icon in the upper-left corner of the folder. You can change the positions of files and folders by clicking and dragging them to a new location on the canvas.

The arrows between files or folders indicate dependencies. Each dependency is represented by an arrow that points from one file to the file it uses.

File Browser

The panel on the left side of the map shows your codebase's entire file and folder tree. You can hide files or folders from the diagram by clicking the “eye” icon. You can also select multiple items by holding down Shift or Ctrl and clicking items.

Right-click to bring up a menu to hide all selected items, or hide everything in the repository except for what you selected.

Use this visibility feature to hide the parts of the repo that are not relevant to the map you are making.

The file browser also includes a search bar at the top, where you can filter by the name of files or folders.

Auto Insights

CodeSee will automatically gather insights from your repository. Use the toggle switches to enable or disable Insights on your Map.

When Insights are displayed on your Map, your labels will be temporarily replaced by those corresponding to the insights themselves. To restore your labels, disable the Insight using the toggle switch.

Screenshot of CodeSee's insights, showing the engineering hot spots insights

Below the File Browser, you'll find three insight types:

  • Engineering Hot Spots: See which files and folders have had the most recent commits.
  • Latest Activity: See when the last commit to a file or folder was made.
  • Creation Date: See when files and folders were created relative to today's date.

Data Panel

The Data Panel allows you to explore the code of the file or folder of your map. Simply click on a node, and the Data Panel will automatically appear under your Map Legend. In addition, the Data Panel provides helpful information about the file or folder.

Panning and zooming

Pan across your map with your mouse’s scroll wheel or by clicking and dragging on the background of the map. Zoom in and out by holding down the Ctrl key while scrolling.

Editing your map

If you are the owner of a map, you also have tools to create annotations to help your team onboard to the codebase, understand team ownership, or learn key flows.

Saving and reverting

As the owner, you will see a “Save” and “Revert” button above the map on the right. Clicking “Save” will preserve the current state of the map. This includes the positions of items and the expanded or collapsed state of any folders. “Revert” will return the map to its last saved state.

Creating a Tour

Tours are a way to create asyncronous, visual walkthroughs on a map. Tours can be used for anything that comes to mind, showing where features are, tricky flows through files, helping to debug and more.

Here's a video of all of Tours!

To create a tour:

  1. Click on the tours icon in your left tool bar.
  2. Click Add a Tour.
  3. Provide a name for your tour.
  4. Click Add a Step.
  5. Click the node in the map where you want to place the first step of your tour.
  6. Add a description to the tour step.
  7. Go back to step 4 and create as many tour steps as you'd like.

Additional tour options:

  1. Click on the ellipses to:
  2. Add a second tour.
  3. Rename a tour.
  4. Delete a tour.

Viewing a Tour:

Tours should just show up on the map!

Switch to view another tour: 1. Select the dropdown next to the name of your tour. 2. Select which tour you would like to view.

Labels and colors

The legend is a panel in the upper-right corner of the map. Here you can choose colors and labels that you can apply to files or folders in your map.

To add a new label to the legend:

  1. Click “Add a new label.”
  2. Click on the placeholder text “New Label” to edit the text for the label at any time.
  3. Click the colored tile on the left to select a color.

You can use labels to designate and color-code team ownership, indicate different codebase features, mark hotspots or tech debt, or whatever would be useful to you.

To assign colors to files or folders: 1. Click the “Color” tool, then choose the color you’d like to paint with. 1. Click on the files or folders you want to paint with that selected color.

Right-Click Menu

Screenshot of CodeSee's right-click menu

By right-clicking on a file or folder, you'll get the following options:

Hide selected items

This will hide the items you've selected from the map.

Show only selected items

This will hide all items that are not selected.

Show all

This will show all files and folders.

Add/edit note

This will allow annotating items.


Use the Notes tool to add additional context to any file and folder.

To add notes to files or folders:

  1. Click on the “Notes” tool.
  2. Click on the file or folder you would like to annotate.
  3. Type your note, then press “Return” to add it to the file or folder.

Notes on folders are available only when the folder is collapsed.

Duplicate a map

To create a copy of a map, click on the overflow button (•••), then select “Duplicate map.”

Note: Create filtered views to share by selecting specific parts of your diagram to show and hide via the File Browser or the Right-Click Menu.

Sharing your map

If you’re the owner of the map, you can share it with others. This can help your team with onboarding or alignment.

Share settings

The share settings below affect only the visibility of the map. Only you, as the owner, will be able to edit it.

To change the share settings of your map:

  1. Click “Share.”
  2. Select one of these options:
    1. GitHub Organization
      1. Only members of your organization on GitHub with the link can view the diagram. GitHub repository members will see the diagram in “Your Maps.”
    2. Public
      1. Anyone with the link can view this diagram. GitHub repository members will see the diagram in “Your Maps.”
    3. Community
      1. Anyone with the link can view this diagram. GitHub repository members will see the diagram in “Your Maps.” Anyone can find it from the CodeSee Community page.