Narcooo/inkos

InkOS – AI‑powered Story‑Creation Agent

What it is – InkOS is a Node‑based AI agent system for writing fiction and related content. It lets you create long‑form novels, short stories, scripts, interactive “play” worlds, and multilingual translations from a single workspace. The core idea is a pi‑agent harness: a language model (e.g., Moonshot Kimi, Claude, Gemini, DeepSeek, etc.) proposes actions, and InkOS executes them deterministically, managing context, state, and file persistence.

Key capabilities

• Unified workbench – Studio (web UI), TUI (terminal UI), and CLI all share the same action engine.
• Multi‑genre pipelines – built‑in “Skills” for novel writing, short‑story generation, script/scene drafting, interactive‑film/play worlds, and translation.
• State‑aware writing – story‑wide memory (SQLite FTS5/BM25), chapter‑level snapshots, and structured JSON state files keep plot threads, character arcs, and foreshadowing consistent.
• Model‑agnostic – works with Moonshot Kimi, Claude, Gemini, DeepSeek, OpenRouter, Ollama, etc. via the kkaiapi aggregation layer; you can route different agents (writer, auditor, radar) to different models.
• Professional workflow – planning → composing → writing → review → atomic commit, with explicit confirmation dialogs and observation logs for auditability.
• Cover‑image generation – optional image service (gpt‑image‑2 or other) creates book covers from prompts.
• OpenClaw skill – can be called from any compatible agent (inkos interact --json --message "…").
• Export – produces markdown, EPUB, and other formats; short‑story bundles include outline, sales‑package, and cover assets.

Installation

# Requires Node 22.16+ 
npm i -g @actalk/inkos

You can also install the OpenClaw skill with clawhub install inkos.

Typical workflow

1. Create a book – inkos book create --title "My Epic" --genre fantasy.
2. Write a chapter – inkos write next My\ Epic (or use the Studio chat UI).
3. Review & revise – inkos review My\ Epic shows observations; inkos revise My\ Epic 12 --instruction "fix timeline" applies a targeted edit.
4. Generate a cover – configure a cover service in Studio, then inkos cover generate "My Epic".
5. Export – inkos export My\ Epic --format epub.

Configuration

• Studio UI – set provider, model, and API key in the visual settings; secrets are stored in .inkos/secrets.json.
• CLI / env – global or project‑level environment variables (INKOS_LLM_PROVIDER, INKOS_LLM_BASE_URL, INKOS_LLM_API_KEY, INKOS_LLM_MODEL, etc.) override Studio settings.
• Multi‑model routing – inkos config set-model writer <model> --provider <provider> lets different agents use different models.

Extensibility

• Add custom Skill files (skills/SKILL.md) to define new professional methods (e.g., a detective‑play skill). Skills are static descriptors; the agent decides when to invoke them.
• Plug in additional retrieval sources via the SQLite memory database.
• Hook up notification channels (Telegram, Feishu, webhook) for long‑running jobs.

Why it matters InkOS tackles the biggest pain point of AI‑assisted fiction: maintaining narrative coherence over many chapters. By separating planning (structured state) from generation (LLM output) and persisting everything atomically, it reduces “lost plot” and “inconsistent character” bugs that plague naïve prompt‑only approaches.

---

Bottom line – InkOS is a full‑stack, open‑source AI authoring platform that combines a web studio, terminal UI, and command‑line tools with a robust agent‑driven pipeline, making large‑scale story creation, interactive world‑building, and multilingual translation more controllable and reproducible.