Kora

A local-first Windows assistant that turns natural-language requests into multi-step actions across personal knowledge, schedules, projects, documents, and browser or desktop applications.

Designed and built by Mobolaji Ogunbiyi · December 2025—Present

Status: active private developmentRole: product, architecture, full-stack implementation, evaluation
DemoCase StudyEvidencePrivate repository
Kora / conversation workspaceProduct UI
Kora desktop conversation workspace with a conversation, activity timeline, and working panel

Guided workflow replay

A sanitized fixture demonstrates the implemented control flow without connecting to private accounts or a live model. Use the controls to inspect each step; the complete reading path remains below without JavaScript.

Request: “Prepare my interview brief and put the final document in my applications folder.”Fixture replay · no private data · read only

1. Plan the work

Kora resolves the requested outcome into a bounded sequence: identify the application, retrieve candidate evidence, research the company, assemble the brief, and save the artifact.

goal: interview_brief
steps: resolve → retrieve → research → compose → save
write_scope: applications/interview-brief.md

2. Retrieve grounded context

The runtime searches durable local sources and returns supporting spans rather than relying on conversation memory alone.

sources: master resume, application record, project evidence
result: 7 cited spans selected

3. Use connected tools

The agent reads the relevant browser page, records the company context, and prepares a document through typed tools. Effects remain explicit and attached to the active run.

browser.read_page → engineering principles
document.compose → structured interview brief
filesystem.write → applications/acme/interview-brief.md

4. Return the artifact and evidence

The final response reports what changed, where the artifact lives, and which sources support it. The session retains enough state to continue after compaction or restart without replaying effects.

completed: true
artifact: applications/acme/interview-brief.md
citations: 7
next: review system-design talking points
Read the complete workflow
  1. Plan the bounded workflow and write scope.
  2. Retrieve cited spans from durable local sources.
  3. Use typed browser, document, and filesystem tools.
  4. Return the saved artifact, citations, and next action.

Contextualized evidence

These results describe the current automated retrieval evaluation—not universal model accuracy or production reliability.

Evaluation corpus
185 search scenarios
Ranking result
99.2% quality
Safety and integrity
0 failures

The suite uses synthetic personal histories. Every correct result appeared within the top five. Separate live tool-selection and operational qualification remain different evidence boundaries.

What I engineered

Product system

One authenticated runtime shared by a Tauri desktop app, CLI, and Chrome extension so the assistant can keep context across surfaces.

Agent runtime

Kora-native orchestration, typed tools and skills, context retrieval, durable SQLite state, and resumable sessions around the Pi runtime.

Evaluation loop

Synthetic histories, repeatable queries, ranking checks, safety assertions, and data-integrity assertions used to guide implementation.

Architecture

Product surfaces share one runtime and durable state instead of duplicating agent behavior in each interface.

Engineering decisions and tradeoffs

Local-first by default

Personal context and durable state stay on the user’s machine. That improves control and inspectability, but makes packaging and cross-device synchronization harder.

One runtime, multiple interfaces

Sharing a runtime avoids behavioral drift. It also requires strict surface contracts so desktop, browser, and CLI clients do not leak internal fields.

Evaluation before claims

Retrieval is measured with repeatable fixtures. A strong offline result does not substitute for connected, long-running, or production evidence.

Current status

Kora is an active private project with a working local runtime, desktop and browser surfaces, durable sessions, typed tools, retrieval, and automated evaluations. It is not presented here as a public hosted service or open-source repository.