Docs

Minimal Examples

Three small apps in the monorepo, each demonstrating one integration pattern in as few lines as possible. Clone the repo, npm install at the root, and run any of them.

apps/web — fully in the tab#

Vanilla JS + Vite, no framework: BrowserAgent running entirely client-side. Paste an Anthropic key (sent straight from the browser via the anthropic-dangerous-direct-browser-access opt-in header), chat, and watch the agent edit a virtual filesystem live. Commented alternatives show fully-local models via WebLLM and transformers.js.

npm run dev -w apps/web

apps/nextjs — server-side behind an API route#

The classic server pattern: @nanocodana/core inside app/api/chat/route.ts, streamed to a React page built on useChat. Use this shape when the key belongs to you (set OPENAI_API_KEY) and the filesystem lives on the server.

npm run dev -w apps/nextjs

apps/node — scripts and demos#

A grab-bag of NodeAgent scripts: a basic chat loop (npm start), skills auto-discovery demos (npm run skills-demo, npm run project-skills-demo), image generation (npm run image-demo), and Forge (npm run forge). Each script is short and heavily commented — they double as documentation.

Deciding between shapes? Browser = the user brings the key and the files stay in the tab. Server = you own the key and the filesystem. Node CLI = the agent works on a real machine's files.