App
narcooo / inkos
Story Creation AI Agent for novel, scripts, translation, interactive games, and IP content
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
| Type | App |
|---|---|
| License | AGPL-3.0 |
| Code health | 6.0 / 10 (Fair) |
| Health rank | #200 of 4,000+ indexed repos |
| Last commit | Aug 1, 2026 |
| Contributors | 13 |
| Bus factor | 1 |
| Size | 780 files, 151,576 lines |
Install inkos
Commands copied from the README
- 1Clone the inkos repository.
git clone https://github.com/narcooo/inkos.git - 2Move into the inkos folder.
cd inkos - 3Install InkOS globally from npm.
npm i -g @actalk/inkos - 4Change into the project folder.
cd my-novel
Releases on GitHub (latest v1.8.0, Aug 17, 2026)
Explore inkos
- DocumentationModule-by-module documentation, 806 pages.
- ArchitectureDependency graph, layers and third-party dependencies.
- Code healthEvery file's score and the findings behind it.
- CommitsEach commit's effect on code health.
- OverviewEverything else the index found: contributors, decisions, what changed this week.
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
- 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
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.
Maintain narcooo/inkos?
Claim this page, add a badge to the README, or re-index it.
Claim this page
Sign in with GitHub and we check that you are an admin or maintainer of narcooo/inkos. Then add a badge to the README that links readers here.
Add a badge to your README
Readers click through to this page and can ask inkos's code a question. A badge also re-indexes the repo every week and marks you as the verified maintainer.
[](https://repowise.dev/repo/narcooo/inkos?src=badge_ask)Paste it at the top of README.md, under the title.
Added it already? Verify to get the mark now instead of tomorrow.
Need HTML or the larger health card? More formatsHide more formats
This badge as HTML
<a href="https://repowise.dev/repo/narcooo/inkos?src=badge_ask"><img src="https://api.repowise.dev/badge/wiki/narcooo/inkos.svg?label=ask" alt="repowise: Ask this codebase"></a>Code health card
The score, its change since the last index, and when it was measured. Follows the reader's light or dark theme.
<a href="https://repowise.dev/repo/narcooo/inkos?src=badge_card"><picture><source media="(prefers-color-scheme: light)" srcset="https://api.repowise.dev/badge/health/narcooo/inkos.svg?style=card&theme=light"><img src="https://api.repowise.dev/badge/health/narcooo/inkos.svg?style=card" alt="repowise code health" width="500" height="168"></picture></a>