DEVELOPMENT.md

Development

Prerequisites

• Node.js 22+
• VS Code with the Extension Development Host

Setup

1. Clone the repository
2. Install dependencies and set up git hooks:

   npm install

Running the Extension

Open the project in VS Code and press F5 to launch the Extension Development Host. The extension activates automatically on startup.

Scripts

Command	Description
npm test	Run tests (Vitest)
npm run ci	Run all checks (test + lint + format)
npm run lint	Lint code (ESLint)
npm run lint:fix	Lint and auto-fix
npm run format	Format code with Prettier
npm run format:check	Check code formatting
npm run package	Package extension as .vsix

Testing

npm test     # Run all tests
npm run ci   # Run tests + lint + format check in one step

Tests use Vitest.

Local Packaging

npm run package

This produces a .vsix file. To install it locally:

code --install-extension my-extension-0.0.1.vsix

Or use Extensions: Install from VSIX in the VS Code UI.

Notes

You must be signed in to GitHub (githubCopilotUsage.signIn) and have an active Copilot subscription.

Tests mock fetch globally — no network calls are made.

Key Technical Notes

• API endpoint: GET https://api.github.com/copilot_internal/user
• Auth: VS Code authentication.getSession('github', ...) — uses the user's existing GitHub session; cancellation handled gracefully via inner try/catch
• Auto-refresh: Configurable interval (1–60 min, default 5 min) via githubCopilotUsage.refreshIntervalMinutes
• Status bar position: Priority 100.099999 — places the indicator just to the right of the Copilot icon (chat.statusBarEntry at 100.1)