Code Narrative AI VS Code Extension

Code Narrative AI brings narrative-style explanations, summaries, and documentation generation for your code directly into VS Code.

Features

• Explain selection: Select any block of code and run Code Narrative AI: Explain Selection to get a rich, narrative explanation.
• Summarize file: Generate a high-level narrative summary of the current file.
• Chat side panel: Use the Code Narrative AI view in the activity bar to chat about your code, ask questions, and explore alternatives.
• Architect-style Dashboard: Open the Dashboard view under Code Narrative AI to get a three-column experience with workspace context, chat, and live code preview, plus slash commands like /explain and /summarize.
• Pixel Office (inspired by Pixel Agents): Enable the Pixel Office view to see Code Narrative AI sessions as agents inside a simple office layout, with a minimal layout editor built into the webview.

Commands

• Code Narrative AI: Explain Selection (codeNarrative.explainSelection)
• Code Narrative AI: Summarize File (codeNarrative.summarizeFile)
• Code Narrative AI: Open Chat (codeNarrative.openChat)
• Code Narrative AI: Open Dashboard (codeNarrative.openDashboard)
• Code Narrative AI: Open Pixel Office (codeNarrative.office.open)

You can access these from the Command Palette or the editor context menu (right-click).

Configuration

In VS Code settings, search for Code Narrative AI:

• codeNarrative.backendType: "remote" (default) or "local".
• codeNarrative.baseUrl: Base URL of the Code Narrative AI HTTP API.
• codeNarrative.apiKey: API key for the service. The extension will also offer to store this securely when first needed.
• codeNarrative.narrativeLevel: "short" or "detailed" narratives by default.
• codeNarrative.office.enabled: Enable or disable the Pixel Office view.
• codeNarrative.office.autoSpawnAgents: Automatically create visual agents for new sessions.
• codeNarrative.office.maxAgents: Maximum visible agents in the office view.

Getting Started

1. Install the extension.
2. Open the Code Narrative AI activity bar view.
3. Configure your backend URL and API key.
4. Select some code and run Explain Selection, or open the chat and start asking questions.

Development

• npm install
• npm run compile
• npm test
• npm run package to create a .vsix for installation or publishing.