Codiko

AI-Assisted Story Engine for Complex Narratives

Overview

Codiko is a desktop writing and story-planning application for macOS and Windows, bringing manuscripts, characters, timelines, worldbuilding and optional AI assistance together in one workspace.

I conceived, designed and developed Codiko as an independent product under Apoko, taking it from an initial idea through to a commercial software release. The project covers everything from product architecture and UI/UX design to branding, AI integrations, licensing, payments and distribution.

It started with a personal problem. I wanted to write a sprawling novel with branching timelines and more characters than I could comfortably keep track of. Existing tools were great at individual tasks, but keeping everything connected was another matter.

So I decided to build something that could do it all.

TheProblem

Writing a novel involves considerably more than writing prose.

Characters evolve, timelines overlap, relationships change and ideas develop as a story progresses. Writers often end up juggling documents, spreadsheets, notes and specialist planning tools to keep everything organised.

AI introduced another possibility, but conventional chat interfaces have limited awareness of an entire writing project.

The challenge was to build a flexible workspace that connected all these elements without forcing writers into a particular workflow, while keeping their work private and under their control.

TheApproach

Rather than building another text editor, I designed Codiko around a connected model of a story.

Manuscripts, characters, locations, events and relationships are represented as structured information that can be explored, linked and referenced throughout a project.

The interface accommodates different approaches to writing. Users can start with a blank manuscript, build an outline, develop characters, organise research or import an existing novel.

AI assistance is available throughout the application, but remains entirely optional.

ProductDesign&UserExperience

Codiko grew from a functional prototype into a fully designed desktop application, with a consistent visual language, custom iconography and flexible navigation.

The interface brings together several ways of working:

  • A manuscript editor with chapters, scenes and contextual information.
  • Visual timelines, outlines and planning boards.
  • Character, location and worldbuilding management.
  • Relationship graphs and connected story information.
  • Research notes, project search and writing tools.

One of the biggest design challenges was making a feature-rich application approachable to someone opening it for the first time.

To address this, I developed guided onboarding, contextual help and flexible starting points, allowing users to explore the features relevant to their writing process.

TechnicalArchitecture

Codiko is built with Tauri, Rust, React and TypeScript, providing a native desktop application for macOS and Windows.

The architecture is local-first. Projects are stored on the user's computer rather than requiring a cloud account or remote database.

Structured project data allows information to be shared across different views and features, while Git-backed version history provides a way to track manuscript changes and restore earlier revisions.

Developing for both operating systems introduced additional challenges around native integration, installers, code signing, notarisation, updates and compatibility.

Context-AwareAIWorkflows

One of the more interesting technical challenges was making AI assistance aware of an entire writing project rather than just the current conversation.

Codiko combines structured story data, project indexing and semantic retrieval to provide relevant context to supported AI models.

This powers several workflows:

  • Project-aware chat: Ask questions about characters, events, timelines and manuscript content.
  • Manuscript analysis: Import existing writing and extract characters, locations, events and relationships.
  • AI-assisted planning: Brainstorm ideas and turn conversations into structured project information.

The application supports OpenAI and Anthropic APIs, alongside local models through Ollama.

Users choose their own AI provider, and AI features aren't required to use the core application.

Local-FirstArchitecture

Privacy and ownership were core design principles.

Codiko stores project data locally and allows users to choose how AI features are powered through:

  • OpenAI
  • Anthropic/Claude
  • Local models via Ollama

This removes platform lock-in and avoids the subscription model commonly found in AI writing tools.

ProductFeatures

Structured Story Management

Codiko combines manuscripts, characters, locations, timeline events and worldbuilding into a single workspace.

Rather than scattering information across documents and spreadsheets, story data is stored as structured entities that can be linked, searched and referenced throughout a project.

This creates a shared knowledge layer that supports both writing and AI-assisted workflows.

AI That Understands Your Project

Traditional AI tools only see the current conversation.

Codiko uses project indexing, semantic search and structured story data to provide relevant context from across the project when generating responses.

Characters, locations, timeline events and manuscript content can all be surfaced automatically, helping maintain continuity across large writing projects.

Built for Long-Term Projects

Novels can take years to write.

Codiko stores projects locally and includes Git-backed version history, allowing writers to track changes, experiment safely and restore previous revisions when needed.

Users can choose between OpenAI, Anthropic or local Ollama models, giving them control over both their data and AI workflow.

TheResult

Codiko evolved from a tool I wanted for my own writing into a commercially released desktop application.

It's been an opportunity to bring together almost every part of my experience: software architecture, interface design, APIs, AI integration, branding and product development.

More importantly, it's a product I'm continuing to develop and use myself.

Codiko - Desktop Writing & Story Planning Application

Codiko - Desktop Writing & Story Planning Application

Apoko
2026

Desktop application combining long-form writing tools, structured knowledge management, semantic search, and AI-assisted workflows within a local-first architecture.