codesee

CodeSee CLI tools

Generating maps locally

• Navigate to the root of the repo you want to map

• Generate a map:

  npx codesee map --typescript -o my-repo.map.json
  

• If you don't already have an API token, generate one with yarn new:api-token

• Upload the map using your API token:

  npx codesee upload -a <your-token> -r <repo-url> -u http://localhost:5198 ./my-repo.map.json
  

Example

Let's say we want to generate a map of Maxime's little-do repository.

• Clone the repo:

  git clone https://github.com/deammer/little-do
  

• Navigate into the repo:

  cd little-do
  

• Generate a map and output it to the little-do.map.json file:

  npx codesee map --typescript -o little-do.map.json
  

• If you don't already have an API token, generate one with yarn new:api-token

• Upload the map to your local server:

  npx codesee upload -a 'your-api-token-in-single-quotes' -r 'https://github.com/deammer/little-do' -u http://localhost:5198 ./little-do.map.json
  

• Your map should now be visible on the /maps page!

Generating insights locally

• Navigate to the root of the repo of your choice

• Generate an insights file (see the available insight types in shared-constants):

  npx codesee insight -i commitCountLast30Days -o codesee.commitCountLast30Days.json
  

• If you don't already have an API token, generate one with yarn new:api-token

• Upload your insights to your local server:

  npx codesee upload -u http://localhost:5198 -t insight -a 'your-api-token-in-single-quotes' -r 'https://github.com/organization/repo-name' codesee.commitCountLast30Days.json