repowiserepowise

App

narcooo / inkos

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

★ 11,219stars on GitHubTypeScriptAGPL-3.0

This connects Repowise to narcooo/inkos's code. It does not install inkos.

Repowise maps public repos from their source. Not affiliated with narcooo. What is Repowise?

github.com/narcooo/inkosIndexed at a6e05d4

What is inkos?

inkos is an AI agent system for writing novels, short stories, scripts, interactive stories and translations. It runs each job as a pipeline of drafting, auditing, revising and settling story state, so characters, settings and plot records stay consistent across chapters. The project is written in TypeScript and published as npm packages. To install it, run git clone https://github.com/narcooo/inkos.git and follow the steps below. Its code health is 6.0 out of 10 (Fair), ranked #200 of 4,000+ indexed repos. The last commit to inkos was on Aug 1, 2026, and 13 people have contributed.

As of commit a6e05d4, indexed Aug 13, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.

For agentsinkos.md

Repo facts: type, license, health, rank, contributors
inkos facts
TypeApp
LicenseAGPL-3.0
Code health6.0 / 10 (Fair)
Health rank#200 of 4,000+ indexed repos
Last commitAug 1, 2026
Contributors13
Bus factor1
Size780 files, 151,576 lines

Install inkos

Commands copied from the README

  1. 1Clone the inkos repository.
    git clone https://github.com/narcooo/inkos.git
  2. 2Move into the inkos folder.
    cd inkos
  3. 3Install InkOS globally from npm.
    npm i -g @actalk/inkos
  4. 4Change into the project folder.
    cd my-novel

Releases on GitHub (latest v1.8.0, Aug 17, 2026)

Full install notes on GitHub

Explore inkos

Ask about this code in your agent

This connects Repowise to inkos's code. It does not install inkos. To install inkos, use the install steps.

Useful if you want to change or fork inkos: your agent can ask how it is put together and get answers that cite its files.

How to use inkos

  1. 1Create a new project folder named my-novel.
    inkos init my-novel

Ask about inkos

Answers come from inkos's README and source, with the files they cite. Two free answers a day without an account.

Want this for your own codebase? Map your repo free

About this page

Get a page like this for your own codebase

Repowise built this map of narcooo/inkos from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Free for 2 public repos, with a page like this one. No card. See how Repowise works

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub

narcooo/inkos FAQ

What is inkos?

inkos is a story creation AI agent for novels, scripts, translation, interactive games and IP content. It is written in TypeScript and published to npm.

How does inkos work?

inkos runs writing work through an agent that drafts, audits, revises and settles story state for each chapter. Work can start from the Studio web app, the TUI or the CLI, and the output is saved as files in the project.

How do I install inkos?

Install inkos with npm i -g @actalk/inkos. Then run inkos init my-novel, change into the my-novel folder and run inkos to start it. See the install steps

What language is inkos written in?

inkos is written mainly in TypeScript, with some JavaScript files. Its packages are published to npm.

How is the inkos code organized?

The code is split into packages: cli holds the command line and terminal interface, core holds the agent and LLM providers, and studio holds the web app.

Who is inkos for?

inkos is for writers and translators who want an AI agent to handle novels, short stories, scripts, interactive games and IP content from one workspace.

What license does inkos use?

inkos uses the AGPL-3.0 license.

Code health

6.0out of 10Fair

Hotspots average 4.0, the place fixes pay off most.

On the leaderboards:#61 of 66 TypeScript repos

Key features of inkos

  • Writes long novels, short stories, scripts and storyboards, with characters, settings and story state kept across chapters.
  • Translates EPUB, text PDF, TXT and Markdown books chapter by chapter and exports TXT, Markdown or EPUB.
  • Runs interactive fiction with branching storylines, variables, flags, character relationships and endings.
  • Reviews and revises chapters under strict, lenient or always revision standards, set at project or book level.
  • Offers Studio, TUI and CLI interfaces that all use one set of actions.

How narcooo/inkos works

Input enters through the command line entry point at packages/cli/src/index.ts, the terminal interface in packages/cli/src/tui/app.ts, or the Studio web app, whose API server is packages/studio/src/api/server.ts. The core package in packages/core holds the writing logic, with packages/core/src/agent/index.ts exposing the agent and packages/core/src/agent/agent-tools.ts defining the tools the agent can call. Model access sits in packages/core/src/llm/providers/index.ts, which connects the agent to the configured model services. The Studio chat page in packages/studio/src/pages/ChatPage.tsx is one front end onto the same agent. Results are saved as files in the book project, and the agent's completion status comes from real tool results and those files.

The codebase has 780 files and 4,505 symbols in 2 modules, led by TypeScript and JavaScript. Code health is 6.0 out of 10, rated fair.