How narcooo/inkos works
InkOS is an AI-assisted story-production workspace for long-form and short fiction, screenplays, interactive worlds, Play, and translation. Users enter through Studio, CLI/TUI, or the documented shared interaction command; the agent harness turns requests into confirmed capabilities and domain-specific production, then persists artifacts and state. The README documents shared harness behavior and major product branches. Source excerpts show Studio routing/API setup and selected server, state, and CLI calls; links for unsampled domain implementations are documented or left unasserted.
Main entry points: runtime.ts Production harness · use-api.ts Studio API client · App.tsx Studio workspace · server.ts Studio API
Components 30
User interfaces
- Studio workspace
packages/studio/src/App.tsx - Chat and creation
packages/studio/src/pages/ChatPage.tsx - Studio API
packages/studio/src/api/server.ts - Studio settings
packages/studio/src/pages/ProjectSettings.tsx - Translation manager
packages/studio/src/pages/TranslationManager.tsx - Import manager
packages/studio/src/pages/ImportManager.tsx - Style manager
packages/studio/src/pages/StyleManager.tsx - CLI commands
packages/cli/src/program.ts - Terminal workspace
packages/cli/src/tui/app.ts - CLI localization
packages/cli/src/localization.ts - Studio API client
packages/studio/src/hooks/use-api.ts - Studio theme
packages/studio/src/hooks/use-theme.ts - Studio language
packages/studio/src/lib/app-language.ts - Service configuration
packages/studio/src/pages/ServiceDetailPage.tsx
Agent runtime
- Production harness
packages/core/src/harness/runtime.ts - Agent worker
packages/core/src/agent/worker-agent.ts - Skills and profiles
packages/core/src/skills/registry.ts - Model providers
packages/core/src/llm/provider.ts
Creative production
- Long-form writing
packages/core/src/pipeline/runner.ts - Short and screen
packages/core/src/pipeline/short-fiction-runner.ts - Interactive film
packages/core/src/interactive-film/generate.ts - Play worlds
packages/core/src/play/play-runner.ts - Translation production
packages/core/src/harness/tools/translation.ts - Narrative forecasting
packages/core/src/forecast/runner.ts
State and services
- Project state
packages/core/src/state/manager.ts - Chapter workspace
packages/core/src/interaction/edit-controller.ts - Atomic persistence
packages/core/src/utils/atomic-file-set.ts - Materials retrieval
packages/core/src/materials/retrieve.ts
Other components
- Studio user
- CLI/TUI user
Connections 29
- Studio user → Studio workspace: uses
- CLI/TUI user → CLI commands: runs
- CLI/TUI user → Terminal workspace: uses
- Studio workspace → Chat and creation: routes to
packages/studio/src/App.tsx - Chat and creation → Studio API client: requests data
- Studio API client → Studio API: calls HTTP API
- Studio settings → Studio API client: uses
- Translation manager → Studio API client: requests data
packages/studio/src/pages/TranslationManager.tsx - Import manager → Studio API client: submits imports
packages/studio/src/pages/ImportManager.tsx - Style manager → Studio API client: submits style
packages/studio/src/pages/StyleManager.tsx - Studio API → Production harness: executes capabilities
packages/studio/src/api/server.ts - Studio API → Long-form writing: runs revision
packages/studio/src/api/server.ts - CLI commands → Production harness: shares interaction
- Terminal workspace → Production harness: shares agent core
- Production harness → Agent worker: runs agent
- Production harness → Skills and profiles: activates skills
- Agent worker → Model providers: requests completion
packages/core/src/agent/worker-agent.ts - Production harness → Long-form writing: dispatches actions
- Production harness → Short and screen: dispatches actions
- Production harness → Interactive film: dispatches actions
- Production harness → Play worlds: dispatches actions
- Production harness → Translation production: dispatches actions
- Production harness → Narrative forecasting: dispatches actions
- Long-form writing → Project state: updates state
- Chapter workspace → Project state: validates edits
packages/core/src/interaction/edit-controller.ts - Project state → Atomic persistence: commits files
packages/core/src/state/manager.ts - Materials retrieval → Production harness: supplies context
- Studio workspace → Studio theme: selects theme
packages/studio/src/App.tsx - Studio workspace → Studio language: sets language
packages/studio/src/App.tsx