upstash / context7

Code

How upstash/context7 is laid out, and where to start for common changes.

There is no import map for this report yet.

Where to start reading

Repository root
Repository root
Likely public API
Likely public API
Likely start-up file
Suggested starting pointAI
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

AI

Add a new CLI command

Register command in CLI router within packages/cli/src/index.ts
Add command to setup flow if needed in packages/cli/src/setup/

Add a new SDK command (e.g., new query type)

Export command from packages/sdk/src/commands/index.ts

Add a new MCP tool/resource

Define tool interface and parameters in packages/mcp/src/lib/tool-names.ts
Create tool handler that calls underlying SDK commands
Register tool in MCP server initialization at packages/mcp/src/index.ts
Add authentication/scope validation if needed in packages/mcp/src/lib/mcp-operation-scope.ts

Add AI SDK agent integration

Export adapter factory from packages/tools-ai-sdk/src/index.ts
Add integration tests in packages/tools-ai-sdk/src/index.test.ts

Change the public API

Trace runtime behavior

Add or update tests

Change build or automation

RepoPilot lists up to 500 files, so a file missing here may still exist.

Files marked “likely” are guessed from their names.

Code quality and hotspots

Largest source files

Branch points70 per file on average
Code issues0 errors, 47 warnings
Largest file1,399 lines
Hotspot load3 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions6 workflows
Tests49 test filesJest/Vitest · 0.42 test files per source file (file count, not coverage)
Dependency updatesDependabot

Test folders: packages/cli/src/__tests__ · packages/mcp/test · packages/cli/src/__tests__/fixtures/cursor

Hotspots

packages/cli/src/commands/setup.ts12 commits in 180 days · 104 branch points
packages/cli/src/setup/agents.ts9 commits in 180 days · 43 branch points
packages/cli/src/utils/auth.ts8 commits in 180 days · 74 branch points
packages/cli/src/commands/docs.ts7 commits in 180 days · 65 branch points
packages/mcp/src/lib/jwt.ts7 commits in 180 days · 37 branch points
packages/mcp/src/lib/api.ts7 commits in 180 days · 32 branch points
packages/cli/src/commands/remove.ts6 commits in 180 days · 102 branch points
packages/cli/src/commands/auth.ts5 commits in 180 days · 35 branch points

Files that change often and branch heavily, highest first. Branch points count if, loop, case, catch, ternary, && and || in the file.