How to set up InkOS with a local or custom LLM provider?

Use `inkos config set-global --provider custom --base-url ` and provide the API key. InkOS supports any OpenAI-compatible interface, with automatic fallback for non-SSE streams to ensure compatibility.

InkOS vs Sudowrite: which is better for automated novel writing?

InkOS excels in long-form continuity with multi-agent auditing and structured memory for hands-off chapter generation, while Sudowrite focuses on creative assistance and real-time suggestions. Choose InkOS for complex, consistency-heavy projects.

How to import existing chapters into InkOS for continuation?

Use `inkos import chapters --from ` with optional split modes; it reverse-engineers truth files from the text, allowing seamless `write next` commands to continue writing without manual setup.

What are the estimated API costs for running InkOS on a full novel?

Costs depend on the LLM models used and chapter count; with multi-model routing, you can balance quality and expense—e.g., using GPT-4 for writing and cheaper models for auditing. Expect token usage based on ~14,500 words per chapter as per the README.

Can InkOS write in languages other than English and Chinese?

Currently, InkOS primarily supports English and Chinese via the `--lang` flag; other languages may work but aren't explicitly optimized, as style analysis and auditing rules are tuned for these languages.

How to customize the writing style or rules in InkOS?

Edit control documents like `author_intent.md` and `current_focus.md` for high-level guidance, or use `inkos style analyze` and `import` to apply statistical fingerprints from reference texts for precise style imitation.

Open-Awesome

InkOS

AGPL-3.0TypeScriptv1.7.1

A CLI AI agent that autonomously writes, audits, and revises novels with human review gates.

GitHub

8.2k stars1.5k forks0 contributors

What is InkOS?

InkOS is an autonomous novel writing CLI AI agent that orchestrates multiple specialized agents to handle the entire creative process—from planning and drafting to auditing and revision. It enables the generation of long-form fiction across genres like fantasy, sci-fi, and urban, with built-in continuity checks and human oversight gates to maintain quality and authorial control.

Target Audience

Authors, writers, and content creators looking to automate the labor-intensive parts of long-form fiction writing, particularly those working in genres like fantasy, sci-fi, xuanhuan, and urban fiction. It is also suitable for developers or technical users who want to integrate AI-assisted writing into their workflows via CLI or as an OpenClaw skill.

Value Proposition

Developers choose InkOS for its fully automated, multi-agent pipeline that ensures narrative consistency through 33-dimension auditing and long-term memory, reducing manual oversight. Its unique selling point is the combination of input governance via editable control documents, style imitation from reference texts, and support for complex writing tasks like fanfiction and continuation of existing works, all while maintaining authorial control through review gates.

Overview

Story Creation AI Agent for novel, scripts, translation, interactive games, and IP content

Use Cases

Best For

Automating the entire novel writing process from planning to revision with zero manual intervention.
Generating long-form fiction with strict continuity and consistency checks across characters, plot, and resources.
Creating fanfiction or continuing existing novels by importing chapters and maintaining canonical consistency.
Imitating specific writing styles by analyzing reference texts and applying statistical fingerprints.
Managing complex narrative elements like pending hooks, subplots, and emotional arcs over many chapters.
Integrating AI writing into developer workflows via CLI, JSON output, or as an OpenClaw skill for external agent orchestration.

Not Ideal For

Casual writers seeking quick, no-configuration story generation for short pieces or prompts
Projects requiring real-time, web-based collaborative writing tools with built-in version control
Non-fiction or technical writing tasks, as the system is optimized for narrative fiction genres

Pros & Cons

Pros

Automated Multi-Agent Pipeline

Orchestrates ten specialized agents to handle planning, drafting, auditing, and revision without manual intervention, ensuring a seamless writing process for long-form fiction.

Comprehensive Continuity Auditing

Checks drafts across 33 dimensions including character memory and plot consistency, with built-in AI detection to maintain narrative integrity and reduce errors.

Structured Long-Term Memory

Uses JSON schemas and SQLite for relevance-based retrieval of truth files, preventing context bloat in long works and enabling efficient fact tracking.

Style Imitation Capabilities

Analyzes reference texts to extract stylistic fingerprints like sentence length and word frequency, then applies them via commands like `inkos style import` for consistent tone.

Cons

Complex Configuration and Setup

Requires setting up LLM providers, API keys, and model routing via CLI commands, which can be daunting for users unfamiliar with technical tools and external APIs.

Dependency on External LLM Services

Incur ongoing costs and relies on API availability; performance and quality are tied to the chosen models, with multi-model routing adding configuration overhead.

Limited Real-Time Collaboration

Primarily CLI and local web studio-based, lacking built-in features for synchronous co-writing or seamless integration with cloud-based writing platforms.

Frequently Asked Questions

Related Projects

agent-of-empires

Manage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.

Stars2,868

Forks277

Last commit9 hours ago

coi

Give each AI agent its own isolated machine with root, Docker, and systemd. Active defense detects and stops threats automatically.

Stars601

Forks50

Last commit12 hours ago

agent-deck

Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.

Stars585

Forks95

Last commit3 days ago

greywall

Container-free, deny-by-default sandbox for AI coding agents. Kernel-enforced filesystem, network, and syscall isolation for Linux and macOS

Stars275

Forks33

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub