CodeGenie
The Enterprise AI Coding Agent — powered by KTern.AI Intelligence
Multi-session orchestration · Worktree-isolated parallel work · Marketplace of skills, modes & MCP servers · Neural codebase search · Browser automation
CodeGenie is an end-to-end AI development platform built into VS Code for teams who need secure, compliance-ready infrastructure, and an extensible agent runtime. It fuses chat-driven coding, autonomous multi-step agents, parallel git worktrees, a curated marketplace, and deep IDE integration into a single experience.
Table of Contents
Highlights
- Agent Manager — orchestrate many concurrent AI sessions across isolated git worktrees from a single panel
- Multi-Mode Agents — Architect, Coder, Debugger, Code-Reviewer, Code-Simplifier, Code-Skeptic, Documentation-Specialist, Frontend-Specialist, Test-Engineer, plus fully custom modes
- Marketplace — install 42+ skills, 79+ MCP servers, modes, and workflows from the curated KTern.AI catalog (
s3://ktern-agentspace-docs) at global or project scope
- Worktree-First Workflow — every session can run in its own git worktree with auto-branching, setup scripts, diff panel, and PR status polling
- Neural Codebase Search — semantic indexing via Qdrant or LanceDB with embeddings
- Browser Automation — first-class Playwright MCP integration with visible or headless Chrome
- Inline Autocomplete — Codestral / Mercury-Edit-powered completions with chat autocomplete and smart inline tasks
- Auto-Approve, Permissions & Checkpoints — granular tool permissions per mode, session snapshots, and one-key auto-approve
- Generated Commit Messages, Code Explanations, Bug Fixes — directly from the editor and SCM panel
Quick Start
Installation
Install CodeGenie from the VS Code Marketplace:
- Open VS Code
- Open the Extensions view (
Ctrl+Shift+X / Cmd+Shift+X)
- Search for CodeGenie
- Click Install
- Sign in with your enterprise credentials when the welcome view appears
- (Optional) Pick a buildspace / project from the profile panel
First Task
- Click the CodeGenie icon in the Activity Bar
- Click the + button to start a new task
- Describe what you want to build, fix, or explore
- Watch CodeGenie plan, edit, run, and verify — approve or auto-approve as it goes
- Review the diff, accept, and commit (with an AI-generated commit message)
Open the Agent Manager
Press Ctrl+Shift+M / Cmd+Shift+M to launch the Agent Manager and start running multiple sessions in parallel.
Agent Manager — Parallel Sessions & Worktrees
The Agent Manager is CodeGenie's flagship orchestration surface. It turns a single VS Code window into a control room for many concurrent AI sessions, each with its own working tree, terminal, and diff view.
What you get
- Multi-Session Orchestration — run several independent agent sessions side-by-side in tabbed panels
- Git Worktree Integration — each session can be backed by its own git worktree, with automatic branch creation and isolation
- Per-Session Setup Scripts — bootstrap commands stored in run automatically when a worktree is created
- Dedicated Terminal — every session ships with its own terminal, focusable with
Ctrl+/
- Live Diff Panel — toggle a side-by-side diff against the base branch with
Ctrl+D
- Git Stats Polling — real-time commit, branch, and file-change indicators per session
- PR Status Bridge — surfaces GitHub PR status next to the worktree it belongs to
- Run Scripts on Demand — execute setup or build scripts with
Ctrl+E and follow progress inline
- Quick-Jump Navigation —
Ctrl+1–Ctrl+9 jumps directly to a session
- Session/Tab Cycling —
Ctrl+Alt+↑/↓ for sessions, Ctrl+Alt+←/→ for tabs
- Persistent State — Agent Manager state lives in agent-manager.json` and survives VS Code restarts
Worktree Operations
| Action |
Shortcut |
| New worktree |
Ctrl+N |
| Open existing worktree |
Ctrl+Shift+O |
| Close current worktree |
Ctrl+Shift+W |
| Advanced new worktree (custom branch / base) |
Ctrl+Shift+N |
| New tab |
Ctrl+T |
| New terminal tab |
Ctrl+Shift+T |
| Close tab |
Ctrl+W |
Multi-Version Experiments
Run the same prompt across up to four parallel worktrees to compare different branches, or modes — perfect for A/B'ing implementation strategies before merging.
Sessions, History & Cloud Sync
- Full Session History — browse every previous task, restore context with one click
- Session Restore on Restart — agent state, tabs, and worktrees rehydrate when VS Code reopens
- Cloud Sessions — import sessions shared from teammates or other devices
- Session Forking — branch a new session off a previous one to explore variations without losing the original
- Local Session List — sessions not yet associated with a worktree appear in the Agent Manager
SESSIONS rail
- Permission Dock — every tool request is logged; approve, deny, or auto-approve from one place
- Question Dock — CodeGenie surfaces follow-up questions and suggested next steps right under the chat
Marketplace — Skills, Modes, MCPs & Workflows
The CodeGenie Marketplace (powered by s3://ktern-agentspace-docs/codegenie/prd/) is a first-party catalog of capabilities you can install at the click of a button.
What's available
| Category |
Count |
Examples |
| Skills |
42+ |
code generation, refactoring, test authoring, documentation, ABAP/SAP-specific helpers |
| Modes / Agents |
8+ built-in + custom |
Architect, Code-Reviewer, Code-Simplifier, Code-Skeptic, Documentation-Specialist, Frontend-Specialist, Test-Engineer |
| MCP Servers |
79+ |
codegenie-playwright, Brave Search, AWS Knowledge Base, Azure DevOps, ClickUp, Apify, Browserbase, Atlassian, Cloudflare, Axiom, and more |
| Workflows |
Templated |
reusable multi-step automations |
| Rules |
Project / global |
persistent guidance auto-loaded into every session |
Installation flow
- Browse, filter by type / category / tags, and preview each item
- Install at global scope (your user) or project scope (only this workspace)
- Parameter-driven MCP installation collects API keys, base URLs, and profiles in a guided modal
- OAuth-enabled MCPs (
mcp-oauth.ts) walk you through the auth flow inline
- Uninstall is local-only — removing a custom item from your install does not unpublish it from the team marketplace; it stays available for reinstall
Custom Artifacts
Author your own modes, skills, workflows, or rules and they appear alongside the curated catalog under a CUSTOM badge. Two creation paths converge on the same on-disk + S3 pipeline:
- Settings UI — Agent Behaviour → Modes / Skills / Workflows / Rules → Create
- Chat-driven — invoke the built-in
create-artifacts skill (e.g. "create a new mode for code review") and the agent gathers fields conversationally, then writes the file
| Artifact |
On-disk path |
Auto-synced to S3 |
| Mode |
.codegenie/agents/<id>.md |
custom/<projectId>/modes/ |
| Skill |
.codegenie/skills/<id>/SKILL.md |
custom/<projectId>/skills/ |
| Workflow |
.codegenie/commands/<id>.md |
custom/<projectId>/workflows/ |
| Rule |
.codegenie/rules/<id>.md |
local-only (no marketplace presence) |
Once a file lands, the FileSystemWatcher invalidates the CLI cache and refreshes the Settings + Marketplace views without a window reload.
Agent Modes
Modes are reusable agent profiles — system prompts, tool permissions, and behavior tuned for a specific job.
Built-in Modes
| Mode |
Best For |
| Architect |
System design, architecture planning, technology decisions |
| Coder |
Feature implementation, refactoring, bug fixes |
| Debugger |
Issue investigation, performance optimization, root-cause analysis |
| Code-Reviewer |
Diff review, second opinions, finding regressions |
| Code-Simplifier |
Reducing complexity, removing dead code |
| Code-Skeptic |
Adversarial review, edge-case hunting |
| Documentation-Specialist |
READMEs, API docs, comments |
| Frontend-Specialist |
React/UI components, styling, accessibility |
| Test-Engineer |
Unit, integration, and E2E test authoring |
Custom Modes
Build your own mode with:
- A custom system prompt tailored to your domain
- Permission rules controlling which tools the mode can use
- Tool whitelist/blacklist per mode
- Response templates for consistent output
Modes are exportable as .agent.json files for sharing across teams. Cycle modes anywhere with Ctrl+. (next) and Ctrl+Shift+. (previous).
Inline Autocomplete & Smart Edits
- Real-time inline completions as you type, powered by Codestral or Mercury-Edit
- Chat autocomplete — completions also appear in the chat input
- Smart inline tasks — invoke an inline AI edit with
Ctrl+L / Cmd+L
- Cancel suggestions with
Escape
- Auto-trigger toggle — disable auto-popups and only complete on demand
- Copilot coexistence — CodeGenie detects if GitHub Copilot completions are active and surfaces a clear handoff
- Context-aware — suggestions can incorporate neural-search context from your indexed codebase
Browser Automation
Powered by the bundled codegenie-playwright MCP server:
- Drive any web app, scrape pages, or generate screenshots from chat
- Choose bundled Chromium or system Chrome
- Run headless for CI-style flows or headed to watch the agent click
- DOM analysis, form filling, network capture, and visual diffs
- Per-project enable toggle so it only loads where you want it
Codebase Indexing & Neural Search
CodeGenie can build a semantic index of your codebase so the agent can find relevant files by meaning, not just keywords.
- Vector stores — Qdrant or LanceDB
- Embedding providers — Bedrock
- Tunable retrieval —
searchMinScore, searchMaxResults, embeddingBatchSize, scannerMaxBatchRetries
- Watcher ignore patterns — keep build artifacts and generated files out of the index
- Per-project on/off — index only the repos that benefit
Diff, Review & Checkpoints
- Visual Diff Viewer — split or unified, with syntax highlighting
- Inline Diff Preview — see exactly what will change before applying
- Markdown Diff Rendering — toggle to render
.md diffs as formatted markdown
- Local Diff Tracking — compare a worktree against its base branch at any time
- Checkpoints / Snapshots — save session state snapshots and roll back if a multi-step plan goes sideways
- PR Status Polling — see CI/PR state alongside the diff so you know when it's safe to merge
Terminal & Git Integration
Terminal
- Generate terminal commands from natural language (
Ctrl+Shift+G)
- Fix the most recent failing command with one right-click
- Explain any selected command in plain English
- Add terminal output to context so the agent can reason about logs/errors
Git / SCM
- AI Commit Messages — generate descriptive, conventional, or gitmoji-style commit messages directly from the SCM panel (
Ctrl+Shift+M)
- Worktree Auto-Branching — every Agent Manager worktree gets its own branch
- Diff-aware Context — staged and unstaged changes can be auto-injected into prompts
Sub-Agents & Task Timeline
- Sub-Agent Viewer — read-only viewer of the full child-session hierarchy spawned by complex agent tasks
- Task Timeline — toggleable graph in the chat header showing each step of agent execution: tool calls, file edits, command runs, decisions
- Permission Dock — central approval surface for tool requests, with per-tool and per-mode auto-approve
- File Mentions — type
@filename to inject file context inline; supports fuzzy search across the workspace
Settings Reference
CodeGenie's settings live in a dedicated, multi-tab editor (open with the gear icon in the sidebar). Settings categories:
Models & Providers
- Temperature & sampling parameters
- Custom system prompts per mode
Agent Behavior
- Custom Modes Editor — build and edit modes in-place
- Permissions Editor — fine-grained tool access per mode
- Auto-Approve (
codegenie.autoApprove.enabled) — global toggle, also bound to Ctrl+Alt+A
- Snapshot / Checkpoints — enable session checkpointing
- Retry behavior & error handling
Autocomplete
codegenie.autocomplete.* — enable, auto-trigger, smart inline tasks, chat autocomplete
Browser Automation
codegenie.browserAutomation.enabledcodegenie.browserAutomation.useSystemChromecodegenie.browserAutomation.headless- Viewport, screenshot quality, session persistence
Codebase Indexing
- Vector store choice (Qdrant / LanceDB)
- Embedding provider and API keys
searchMinScore, searchMaxResults, embeddingBatchSize, scannerMaxBatchRetries- File watcher patterns (
watcher.ignore)
Notifications & Sounds
codegenie.notifications.* — task complete, permission requests, errorscodegenie.sounds.* — audio cues- Notification timeout
Display
codegenie.fontSize (10–24)codegenie.language — 16 UI languages- Light / dark / system theme
- Sidebar/panel sizing
Context Management
- Context window size
- Auto-compaction
- File-inclusion heuristics
- Dependency analysis depth
- Conversation memory limits
Diff & UI
codegenie.showTaskTimelinecodegenie.diff.renderMarkdown
Commit Message Generation
- Style template (conventional / gitmoji / plain)
- Issue-number linking
- Min/max length
- Automatic scope detection
Experimental
- Beta features toggle
- Advanced agent reasoning
- Beta provider support
- Neural search (when not yet GA in your build)
General
- Debug mode / verbose logging
- Telemetry opt-out
- Update behavior
Commands & Keyboard Shortcuts
All shortcuts use Ctrl on Linux/Windows and Cmd on macOS.
Core
| Command |
Shortcut |
| New Task |
codegenie.plusButtonClicked |
| Open Agent Manager |
Ctrl+Shift+M |
| Focus Chat Input |
Ctrl+Shift+A |
| Open in Tab |
codegenie.openInTab |
| Settings |
codegenie.settingsButtonClicked |
| History |
codegenie.historyButtonClicked |
| Toggle Auto-Approve |
Ctrl+Alt+A |
| Cycle Agent Mode |
Ctrl+. |
| Cycle Previous Mode |
Ctrl+Shift+. |
Code Actions (right-click in editor)
| Command |
Shortcut |
| Explain Code |
codegenie.explainCode |
| Fix Code |
codegenie.fixCode |
| Improve Code |
codegenie.improveCode |
| Add to Context |
Ctrl+K Ctrl+A |
Terminal
| Command |
Shortcut |
| Generate Terminal Command |
Ctrl+Shift+G |
| Fix This Command |
codegenie.terminalFixCommand |
| Explain This Command |
codegenie.terminalExplainCommand |
| Add Terminal Content to Context |
codegenie.terminalAddToContext |
Autocomplete
| Command |
Shortcut |
| Generate Suggestions |
Ctrl+L |
| Cancel Suggestions |
Escape |
Commit
| Command |
Shortcut |
| Generate Commit Message |
Ctrl+Shift+M (in SCM) |
Agent Manager (panel-scoped)
| Command |
Shortcut |
| Previous Session |
Ctrl+Alt+↑ |
| Next Session |
Ctrl+Alt+↓ |
| Previous Tab |
Ctrl+Alt+← |
| Next Tab |
Ctrl+Alt+→ |
| Show Terminal |
Ctrl+/ |
| Run Script |
Ctrl+E |
| Toggle Diff Panel |
Ctrl+D |
| Show Shortcuts |
Ctrl+Shift+/ |
| New Tab |
Ctrl+T |
| New Terminal Tab |
Ctrl+Shift+T |
| Close Tab |
Ctrl+W |
| New Worktree |
Ctrl+N |
| Open Worktree |
Ctrl+Shift+O |
| Close Worktree |
Ctrl+Shift+W |
| Advanced Worktree |
Ctrl+Shift+N |
| Jump to Session 1–9 |
Ctrl+1 … Ctrl+9 |
Enterprise & Security
CodeGenie is built for regulated environments:
- Buildspace / Project Scoping — isolate marketplace items, settings, and sessions per project
- Granular Permissions — every tool call goes through the Permission Dock; auto-approve only what you trust
- Telemetry Opt-Out — usage analytics can be fully disabled
- Local-First State — Agent Manager state, sessions, and worktrees live inside your repo
- Audit-Friendly Diffs — every change is reviewable before it touches disk
Resources
- Documentation — see
docs/ for deep-dives into Agent Manager, Marketplace, MCP integration, and provider configuration
- Changelog — see CHANGELOG.md
- License — see LICENSE
CodeGenie · KTern.AI Intelligence · Built for the enterprise
| |
