KodaCode

NORMALKodaCodeProject Performance Review and Enhancementsopenai-codex gpt-5.5· 1.1M ·√R √T √Vctx 53.7k/922.0k 5%|↑161.6k ↓2.6k|est. $0.8456

Review the current project and recommend performance enhancements

Explored · 4 locate · 25 read

Reviewed backend, DB access patterns, caching, frontend routing/bundling, and Pinia stores. Recommended performance enhancements:

High impact

1. Use `.lean()` for read-heavy Mongoose queriesCurrent list/detail queries return full Mongoose documents in:src/repositories/TaskRepository.tssrc/repositories/ProjectRepository.tssrc/services/ProjectStatsService.tsFor API responses that do not mutate documents, add .lean() to reduce memory and serialization overhead.
2. Avoid offset pagination for large collectionsCurrent APIs use .skip(skip).limit(limit) for tasks, projects, proposals, and time entries.Add cursor pagination using _id, createdAt, or updatedAt.GET /api/tasksGET /api/projectsGET /api/time-entries
3. Improve task list query shapeTaskController.listTasks currently performs allowed-project lookup, task query, count query, and user/project population.

DetailsTools

▾ Explored

• Read package.json (lines 1-69)
• Locate src - 50 paths
• Read server.ts (lines 1-214)
• Read cache.ts (lines 1-152)
• Read TaskRepository.ts
• Read ProjectRepository.ts
• Read tasks.ts (lines 1-84)
• Read projects.ts (lines 1-103)
• Read main.ts (lines 1-56)
• Read index.ts (lines 1-148)
• Read vite.config.ts - failed
• Locate client/src/stores
• Read taskStore.ts (lines 1-298)
• Read projectStore.ts (lines 1-490)
• Read authStore.ts (lines 1-202)

Ask kodacode...

builder · ./ main · 1 changed · 6 roundtrips · 29 tools? shortcuts

Agent system

Builder edits directly. Engineer keeps workflow state explicit. Reviewer checks changes without editing. Planner stays read-only for analysis. Switch with Tab.

Agents:
  ▸ builder    direct implementation
  ▹ engineer   workflow + execution
  ▹ reviewer   read-only review
  ▹ planner    read-only planning

Sandboxed

Filesystem authority starts at the working directory. External paths and network access surface as explicit approvals.

Multi-provider

Route across native OpenAI, Anthropic, Google, NVIDIA, GitHub Copilot, DeepSeek, or compatible OpenAI-style provider presets.

20+ built-in tools

File edits, repo search, LSP actions, Git inspection, test execution, web fetch, workflow tasks, and extension through MCP.

read  write  apply_patch  search  locate
symbols  definition  diagnostics  rename_symbol
code_action  mkdir  bash  test
git_diff  git_show  git_status  web_fetch
task_workflow  task_review  memory  search_skills  + MCP

Repo Search

Use `search` for file contents and `locate` for paths or glob matches. The split keeps each tool contract narrow and explicit.

▸ search query="authentication middleware" path="." mode="lexical"
  internal/middleware/auth.go:45  ValidateJWT
  internal/auth/session.go:12     NewAuthMiddleware

▸ locate query="internal/auth/**/*.ts" path="."
  internal/auth/authentication.ts

Cost control

Budgets, terse replies, utility-model routing, compaction savings, and traceable turn cost inspection.

LSP intelligence

Definitions, symbols, diagnostics, trace, refs, rename, and code actions are runtime tools, not editor-only integrations.

Sessions & replay

Workspace sessions persist to SQLite, can be resumed later, and can branch from completed turns while related sessions stay navigable.

Prompt visibility

Prompt assembly, pruning, compaction, and workflow decisions are emitted as stored runtime data instead of hidden behavior.

MCP ready

Use built-in tools and MCP servers side by side under the same runtime-owned permission model.

Context management

Pruning and compaction are explicit session artifacts. Long conversations stay inspectable instead of silently rewritten.

Model routing

Choose one primary model and a cheaper utility model for runtime utility text work such as title generation and compaction summaries.

---

Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/sageil/kodacode/main/install.sh | sh

Homebrew

brew tap sageil/tap && brew install --cask kodacode

Go

go install github.com/sageil/kodacode/cmd/kodacode@latest

Search is built into the app. No separate search binary is required.

Then run kodacode to start.

Learn KodaCode

If you want the docs to feel guided instead of encyclopedic, start here:

• New to the product: Introduction then Quick Start
• Want task-oriented guidance: Common Workflows
• Need core concepts: Sessions, Agents, Project Memory & Instructions, Tools, and Sandbox & Permissions
• Need model and cost controls: Providers, Model Routing, Context Management, Budgets, and Cost Tracking & Optimization
• Need extensions: MCP Servers, Skills, Web Search, Search, and Code Intelligence & LSP
• Need exact knobs and commands: Configuration, Slash Commands, Navigation Keys, Keyboard Shortcuts, and TUI Layouts