Install
| Platform | Start here |
|---|
| Desktop or mobile browser | Open naklios.dev. The browser's install action can add it as an app. |
| macOS, Linux, Windows development | Install Node 24 and Git, then run the source checkout below. |
Create the welcome note, or open an app from a task folder.
The desktop's search opens with ⌘K or Ctrl+K. For a local checkout:
git clone https://github.com/NakliTechie/nakliOS.git
cd nakliOS
node scripts/serve-coi.mjs
Open http://127.0.0.1:8947/; the server supplies the headers needed by Forge, Anvil, and Dish.
If a Books checkout sits beside NakliOS, the server serves it at /Books/ for
Lorewell's local embed. It also finds that checkout from a NakliOS worktree under
.worktrees/. Use --books-root /path/to/Books for another location.
No package installation or NakliOS account is required. Try Notes with Browser storage before connecting a folder, cloud storage, or AI.
Why
Your notes, files, media, and coding tasks occupy separate browser tabs with separate storage settings.
NakliOS gives those tools a desktop, app windows, and shared storage and inference settings.
Apps retain their standalone entrypoints.
Choose where your work lives
Apps offer storage according to their capabilities: Browser storage, a Folder you select, or encrypted Crate storage on your own Cloudflare R2.
Switching storage does not copy or delete existing data. Files browses connected Folder or Crate storage.
Immersive mode opens compatible apps in windows; Basic mode opens other web apps in tabs. See the Experience mode policy.
Local tools need no model. General AI can use supported browser models or your configured endpoint.
Coding agents use the configured endpoint; prompts and selected context go to that provider.
Settings → AI controls the destination. Storage and AI details explain grants, credentials, and runtime downloads.
Edit and automate with Forge and Anvil
Open Forge for a terminal or Anvil for projects, tasks, tool traces, and change previews.
Both execute shell edits, recursive search, loops, functions, substitutions, archives, and structured-data commands over your workspace.
The Unix command reference lists supported flags, numeric tools, encodings, checksums, and explicit capability refusals.
SQLite uses Kiln's optional Pyodide runtime. Bounded-read commands require a compatible storage backend.
Anvil applies hooks, permission rules, protected paths, and file grants around shell execution.
Its executor accepts staged operations internally and records confirmation receipts.
Stop cancels pending work; an already accepted operation can finish.
The Kothri handoff pins the reusable core; Kothri packaging and public APIs remain future work.
Dish
Dish hosts the pinned DeepSeek Harness browser Worker beside Anvil.
It uses NakliOS shared inference and the selected storage backend.
The Dish reference describes persistence, runtime limits, and reproducible packaging.
Add your own tools
Settings → Apps → Add app from manifest installs a personal app for this browser profile.
The app standard covers isolation, declared capabilities, lifecycle, and first-use consent.
First-party apps use the SDK contract for host storage and AI.
The desktop reference preserves catalog, mirroring, and SDK-vendoring instructions.
Commands
Run these in Forge after opening a workspace:
help # list commands, flags, and unavailable capabilities
pwd # show the workspace directory
ls # list its contents
for n in one two; do echo "$n"; done # run a bounded shell loop
git status # inspect an initialized workspace repository
agent "Summarize this project" # use the configured coding endpoint
Anvil exposes the same governed shell through its agent tool; llms.txt points coding agents to the contracts.
Verify it yourself
From the repository root with Node 24:
node --experimental-vm-modules scripts/test-unix-portability.mjs c3553134571d1d601bfdbf857f6b3df138a6bf4f
node scripts/test-anvil-unix-integration.mjs
node scripts/test-sqlite-browser.mjs
node scripts/test-kiln-network-denial-browser.mjs
The browser checks require Chrome and network access for pinned Pyodide assets; failures and incomplete reports fail the gate.
The full CI workflow covers the wider desktop; these commands check portability, Anvil dispatch, SQLite, and network denials.
Deployed checks cover Forge archives and Anvil Stop/recovery; the shell remains a documented Unix subset.
License
MIT. See LICENSE; vendored dependencies retain their own licenses and provenance files.
Rig design · Desktop reference · History · llms.txt
