# freebuff_vscode_extension

**Repository Path**: wangshuyu/freebuff_vscode_extension

## Basic Information

- **Project Name**: freebuff_vscode_extension
- **Description**: freebuff VScode的扩展 
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Freebuff AI for VS Code

This is the Freebuff AI VS Code extension built on the repository's existing Freebuff protocol and SDK.

## MVP capabilities

- Browser-based Freebuff login and logout
- Token storage through VS Code `SecretStorage`
- Freebuff model selection
- Model session admission and polling
- Text chat against the active workspace
- Streaming assistant output
- Stop response and start a new conversation

## Development

From the repository root:

```bash
bun --cwd vscode-extension typecheck
bun --cwd vscode-extension build
```

The build produces `vscode-extension/dist/extension.js`. Open the `vscode-extension` directory in VS Code and press `F5` using the `Run Freebuff AI Extension` launch configuration.

## Architecture

The extension host reuses:

- `@codebuff/sdk` for agent execution and streaming
- `common/src/constants/freebuff-models.ts` for the model catalog
- `common/src/constants/free-agents.ts` for model-to-root-agent mapping
- The existing `/api/auth/cli/*` login protocol
- The existing `/api/v1/freebuff/session` admission protocol

The Sidebar Webview owns presentation only. API tokens and SDK execution stay in the extension host.

## Current limitations

- Text messages only; file/image attachment UI is not implemented yet.
- Tool calls are summarized in the chat; `ask_user` and rich diff approval still need a VS Code-specific bridge.
- Conversation state is currently held in memory for the extension session; durable history is the next step.
- This MVP targets Freebuff's hosted free-mode flow, not the paid Codebuff mode.