@neocode-ai/web 1.1.1

package/src/content/docs/web.mdx

@@ -0,0 +1,136 @@
+---
+title: Web
+description: Using NeoCode in your browser.
+---
+
+NeoCode can run as a web application in your browser, providing the same powerful AI coding experience without needing a terminal.
+
+![NeoCode Web - New Session](../../assets/web/web-homepage-new-session.png)
+
+## Getting Started
+
+Start the web interface by running:
+
+```bash
+neocode web
+```
+
+This starts a local server on `127.0.0.1` with a random available port and automatically opens NeoCode in your default browser.
+
+:::caution
+If `NEOCODE_SERVER_PASSWORD` is not set, the server will be unsecured. This is fine for local use but should be set for network access.
+:::
+
+:::tip[Windows Users]
+For the best experience, run `neocode web` from [WSL](/docs/windows-wsl) rather than PowerShell. This ensures proper file system access and terminal integration.
+:::
+
+---
+
+## Configuration
+
+You can configure the web server using command line flags or in your [config file](/docs/config).
+
+### Port
+
+By default, NeoCode picks an available port. You can specify a port:
+
+```bash
+neocode web --port 4096
+```
+
+### Hostname
+
+By default, the server binds to `127.0.0.1` (localhost only). To make NeoCode accessible on your network:
+
+```bash
+neocode web --hostname 0.0.0.0
+```
+
+When using `0.0.0.0`, NeoCode will display both local and network addresses:
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### mDNS Discovery
+
+Enable mDNS to make your server discoverable on the local network:
+
+```bash
+neocode web --mdns
+```
+
+This automatically sets the hostname to `0.0.0.0` and advertises the server as `neocode.local`.
+
+### CORS
+
+To allow additional domains for CORS (useful for custom frontends):
+
+```bash
+neocode web --cors https://example.com
+```
+
+### Authentication
+
+To protect access, set a password using the `NEOCODE_SERVER_PASSWORD` environment variable:
+
+```bash
+NEOCODE_SERVER_PASSWORD=secret neocode web
+```
+
+The username defaults to `neocode` but can be changed with `NEOCODE_SERVER_USERNAME`.
+
+---
+
+## Using the Web Interface
+
+Once started, the web interface provides access to your NeoCode sessions.
+
+### Sessions
+
+View and manage your sessions from the homepage. You can see active sessions and start new ones.
+
+![NeoCode Web - Active Session](../../assets/web/web-homepage-active-session.png)
+
+### Server Status
+
+Click "See Servers" to view connected servers and their status.
+
+![NeoCode Web - See Servers](../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## Attaching a Terminal
+
+You can attach a terminal TUI to a running web server:
+
+```bash
+# Start the web server
+neocode web --port 4096
+
+# In another terminal, attach the TUI
+neocode attach http://localhost:4096
+```
+
+This allows you to use both the web interface and terminal simultaneously, sharing the same sessions and state.
+
+---
+
+## Config File
+
+You can also configure server settings in your `neocode.json` config file:
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+Command line flags take precedence over config file settings.

package/src/content/docs/windows-wsl.mdx

@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Run NeoCode on Windows using WSL for the best experience.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+While NeoCode can run directly on Windows, we recommend using [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) for the best experience. WSL provides a Linux environment that works seamlessly with NeoCode's features.
+
+:::tip[Why WSL?]
+WSL offers better file system performance, full terminal support, and compatibility with development tools that NeoCode relies on.
+:::
+
+---
+
+## Setup
+
+<Steps>
+
+1. **Install WSL**
+
+   If you haven't already, [install WSL](https://learn.microsoft.com/en-us/windows/wsl/install) using the official Microsoft guide.
+
+2. **Install NeoCode in WSL**
+
+   Once WSL is set up, open your WSL terminal and install NeoCode using one of the [installation methods](/docs/).
+
+   ```bash
+   curl -fsSL https://raw.githubusercontent.com/neopilot-ai/neocode/refs/heads/dev/install | bash
+   ```
+
+3. **Use NeoCode from WSL**
+
+   Navigate to your project directory (access Windows files via `/mnt/c/`, `/mnt/d/`, etc.) and run NeoCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   neocode
+   ```
+
+</Steps>
+
+---
+
+## Desktop App + WSL Server
+
+If you prefer using the NeoCode Desktop app but want to run the server in WSL:
+
+1. **Start the server in WSL** with `--hostname 0.0.0.0` to allow external connections:
+
+   ```bash
+   neocode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Connect the Desktop app** to `http://localhost:4096`
+
+:::note
+If `localhost` does not work in your setup, connect using the WSL IP address instead (from WSL: `hostname -I`) and use `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+When using `--hostname 0.0.0.0`, set `NEOCODE_SERVER_PASSWORD` to secure the server.
+
+```bash
+NEOCODE_SERVER_PASSWORD=your-password neocode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Web Client + WSL
+
+For the best web experience on Windows:
+
+1. **Run `neocode web` in the WSL terminal** rather than PowerShell:
+
+   ```bash
+   neocode web --hostname 0.0.0.0
+   ```
+
+2. **Access from your Windows browser** at `http://localhost:<port>` (NeoCode prints the URL)
+
+Running `neocode web` from WSL ensures proper file system access and terminal integration while still being accessible from your Windows browser.
+
+---
+
+## Accessing Windows Files
+
+WSL can access all your Windows files through the `/mnt/` directory:
+
+- `C:` drive → `/mnt/c/`
+- `D:` drive → `/mnt/d/`
+- And so on...
+
+Example:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+neocode
+```
+
+:::tip
+For the smoothest experience, consider cloning/copying your repo into the WSL filesystem (for example under `~/code/`) and running NeoCode there.
+:::
+
+---
+
+## Tips
+
+- Keep NeoCode running in WSL for projects stored on Windows drives - file access is seamless
+- Use VS Code's [WSL extension](https://code.visualstudio.com/docs/remote/wsl) alongside NeoCode for an integrated development workflow
+- Your NeoCode config and sessions are stored within the WSL environment at `~/.local/share/neocode/`

package/src/content/docs/zen.mdx

@@ -0,0 +1,251 @@
+---
+title: Zen
+description: Curated list of models provided by NeoCode.
+---
+
+import config from "../../../config.mjs"
+export const console = config.console
+export const email = `mailto:${config.email}`
+
+NeoCode Zen is a list of tested and verified models provided by the NeoCode team.
+
+:::note
+NeoCode Zen is currently in beta.
+:::
+
+Zen works like any other provider in NeoCode. You login to NeoCode Zen and get
+your API key. It's **completely optional** and you don't need to use it to use
+NeoCode.
+
+---
+
+## Background
+
+There are a large number of models out there but only a few of
+these models work well as coding agents. Additionally, most providers are
+configured very differently; so you get very different performance and quality.
+
+:::tip
+We tested a select group of models and providers that work well with NeoCode.
+:::
+
+So if you are using a model through something like OpenRouter, you can never be
+sure if you are getting the best version of the model you want.
+
+To fix this, we did a couple of things:
+
+1. We tested a select group of models and talked to their teams about how to
+   best run them.
+2. We then worked with a few providers to make sure these were being served
+   correctly.
+3. Finally, we benchmarked the combination of the model/provider and came up
+   with a list that we feel good recommending.
+
+NeoCode Zen is an AI gateway that gives you access to these models.
+
+---
+
+## How it works
+
+NeoCode Zen works like any other provider in NeoCode.
+
+1. You sign in to **<a href={console}>NeoCode Zen</a>**, add your billing
+   details, and copy your API key.
+2. You run the `/connect` command in the TUI, select NeoCode Zen, and paste your API key.
+3. Run `/models` in the TUI to see the list of models we recommend.
+
+You are charged per request and you can add credits to your account.
+
+---
+
+## Endpoints
+
+You can also access our models through the following API endpoints.
+
+| Model              | Model ID           | Endpoint                                                  | AI SDK Package              |
+| ------------------ | ------------------ | --------------------------------------------------------- | --------------------------- |
+| GPT 5.2            | gpt-5.2            | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5.2 Codex      | gpt-5.2-codex      | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5.1            | gpt-5.1            | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5.1 Codex      | gpt-5.1-codex      | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5.1 Codex Max  | gpt-5.1-codex-max  | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5.1 Codex Mini | gpt-5.1-codex-mini | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5              | gpt-5              | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5 Codex        | gpt-5-codex        | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| GPT 5 Nano         | gpt-5-nano         | `https://neo.khulnasoft.com/zen/v1/responses`             | `@ai-sdk/openai`            |
+| Claude Sonnet 4.5  | claude-sonnet-4-5  | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| Claude Sonnet 4    | claude-sonnet-4    | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| Claude Haiku 4.5   | claude-haiku-4-5   | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| Claude Haiku 3.5   | claude-3-5-haiku   | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| Claude Opus 4.5    | claude-opus-4-5    | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| Claude Opus 4.1    | claude-opus-4-1    | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| Gemini 3 Pro       | gemini-3-pro       | `https://neo.khulnasoft.com/zen/v1/models/gemini-3-pro`   | `@ai-sdk/google`            |
+| Gemini 3 Flash     | gemini-3-flash     | `https://neo.khulnasoft.com/zen/v1/models/gemini-3-flash` | `@ai-sdk/google`            |
+| MiniMax M2.1       | minimax-m2.1       | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| MiniMax M2.1 Free  | minimax-m2.1-free  | `https://neo.khulnasoft.com/zen/v1/messages`              | `@ai-sdk/anthropic`         |
+| GLM 4.7            | glm-4.7            | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| GLM 4.7 Free       | glm-4.7-free       | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| GLM 4.6            | glm-4.6            | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| Kimi K2.5          | kimi-k2.5          | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| Kimi K2.5 Free     | kimi-k2.5-free     | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| Kimi K2 Thinking   | kimi-k2-thinking   | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| Kimi K2            | kimi-k2            | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| Qwen3 Coder 480B   | qwen3-coder        | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+| Big Pickle         | big-pickle         | `https://neo.khulnasoft.com/zen/v1/chat/completions`      | `@ai-sdk/openai-compatible` |
+
+The [model id](/docs/config/#models) in your NeoCode config
+uses the format `neocode/<model-id>`. For example, for GPT 5.2 Codex, you would
+use `neocode/gpt-5.2-codex` in your config.
+
+---
+
+### Models
+
+You can fetch the full list of available models and their metadata from:
+
+```
+https://neo.khulnasoft.com/zen/v1/models
+```
+
+---
+
+## Pricing
+
+We support a pay-as-you-go model. Below are the prices **per 1M tokens**.
+
+| Model                             | Input  | Output | Cached Read | Cached Write |
+| --------------------------------- | ------ | ------ | ----------- | ------------ |
+| Big Pickle                        | Free   | Free   | Free        | -            |
+| MiniMax M2.1 Free                 | Free   | Free   | Free        | -            |
+| MiniMax M2.1                      | $0.30  | $1.20  | $0.10       | -            |
+| GLM 4.7 Free                      | Free   | Free   | Free        | -            |
+| GLM 4.7                           | $0.60  | $2.20  | $0.10       | -            |
+| GLM 4.6                           | $0.60  | $2.20  | $0.10       | -            |
+| Kimi K2.5 Free                    | Free   | Free   | Free        | -            |
+| Kimi K2.5                         | $0.60  | $3.00  | $0.08       | -            |
+| Kimi K2 Thinking                  | $0.40  | $2.50  | -           | -            |
+| Kimi K2                           | $0.40  | $2.50  | -           | -            |
+| Qwen3 Coder 480B                  | $0.45  | $1.50  | -           | -            |
+| Claude Sonnet 4.5 (≤ 200K tokens) | $3.00  | $15.00 | $0.30       | $3.75        |
+| Claude Sonnet 4.5 (> 200K tokens) | $6.00  | $22.50 | $0.60       | $7.50        |
+| Claude Sonnet 4 (≤ 200K tokens)   | $3.00  | $15.00 | $0.30       | $3.75        |
+| Claude Sonnet 4 (> 200K tokens)   | $6.00  | $22.50 | $0.60       | $7.50        |
+| Claude Haiku 4.5                  | $1.00  | $5.00  | $0.10       | $1.25        |
+| Claude Haiku 3.5                  | $0.80  | $4.00  | $0.08       | $1.00        |
+| Claude Opus 4.5                   | $5.00  | $25.00 | $0.50       | $6.25        |
+| Claude Opus 4.1                   | $15.00 | $75.00 | $1.50       | $18.75       |
+| Gemini 3 Pro (≤ 200K tokens)      | $2.00  | $12.00 | $0.20       | -            |
+| Gemini 3 Pro (> 200K tokens)      | $4.00  | $18.00 | $0.40       | -            |
+| Gemini 3 Flash                    | $0.50  | $3.00  | $0.05       | -            |
+| GPT 5.2                           | $1.75  | $14.00 | $0.175      | -            |
+| GPT 5.2 Codex                     | $1.75  | $14.00 | $0.175      | -            |
+| GPT 5.1                           | $1.07  | $8.50  | $0.107      | -            |
+| GPT 5.1 Codex                     | $1.07  | $8.50  | $0.107      | -            |
+| GPT 5.1 Codex Max                 | $1.25  | $10.00 | $0.125      | -            |
+| GPT 5.1 Codex Mini                | $0.25  | $2.00  | $0.025      | -            |
+| GPT 5                             | $1.07  | $8.50  | $0.107      | -            |
+| GPT 5 Codex                       | $1.07  | $8.50  | $0.107      | -            |
+| GPT 5 Nano                        | Free   | Free   | Free        | -            |
+
+You might notice _Claude Haiku 3.5_ in your usage history. This is a [low cost model](/docs/config/#models) that's used to generate the titles of your sessions.
+
+:::note
+Credit card fees are passed along at cost (4.4% + $0.30 per transaction); we don't charge anything beyond that.
+:::
+
+The free models:
+
+- GLM 4.7 Free is available on NeoCode for a limited time. The team is using this time to collect feedback and improve the model.
+- Kimi K2.5 Free is available on NeoCode for a limited time. The team is using this time to collect feedback and improve the model.
+- MiniMax M2.1 Free is available on NeoCode for a limited time. The team is using this time to collect feedback and improve the model.
+- Big Pickle is a stealth model that's free on NeoCode for a limited time. The team is using this time to collect feedback and improve the model.
+
+<a href={email}>Contact us</a> if you have any questions.
+
+---
+
+### Auto-reload
+
+If your balance goes below $5, Zen will automatically reload $20.
+
+You can change the auto-reload amount. You can also disable auto-reload entirely.
+
+---
+
+### Monthly limits
+
+You can also set a monthly usage limit for the entire workspace and for each
+member of your team.
+
+For example, let's say you set a monthly usage limit to $20, Zen will not use
+more than $20 in a month. But if you have auto-reload enabled, Zen might end up
+charging you more than $20 if your balance goes below $5.
+
+---
+
+## Privacy
+
+All our models are hosted in the US. Our providers follow a zero-retention policy and do not use your data for model training, with the following exceptions:
+
+- Big Pickle: During its free period, collected data may be used to improve the model.
+- GLM 4.7 Free: During its free period, collected data may be used to improve the model.
+- Kimi K2.5 Free: During its free period, collected data may be used to improve the model.
+- MiniMax M2.1 Free: During its free period, collected data may be used to improve the model.
+- OpenAI APIs: Requests are retained for 30 days in accordance with [OpenAI's Data Policies](https://platform.openai.com/docs/guides/your-data).
+- Anthropic APIs: Requests are retained for 30 days in accordance with [Anthropic's Data Policies](https://docs.anthropic.com/en/docs/claude-code/data-usage).
+
+---
+
+## For Teams
+
+Zen also works great for teams. You can invite teammates, assign roles, curate
+the models your team uses, and more.
+
+:::note
+Workspaces are currently free for teams as a part of the beta.
+:::
+
+Managing your workspace is currently free for teams as a part of the beta. We'll be
+sharing more details on the pricing soon.
+
+---
+
+### Roles
+
+You can invite teammates to your workspace and assign roles:
+
+- **Admin**: Manage models, members, API keys, and billing
+- **Member**: Manage only their own API keys
+
+Admins can also set monthly spending limits for each member to keep costs under control.
+
+---
+
+### Model access
+
+Admins can enable or disable specific models for the workspace. Requests made to a disabled model will return an error.
+
+This is useful for cases where you want to disable the use of a model that
+collects data.
+
+---
+
+### Bring your own key
+
+You can use your own OpenAI or Anthropic API keys while still accessing other models in Zen.
+
+When you use your own keys, tokens are billed directly by the provider, not by Zen.
+
+For example, your organization might already have a key for OpenAI or Anthropic
+and you want to use that instead of the one that Zen provides.
+
+---
+
+## Goals
+
+We created NeoCode Zen to:
+
+1. **Benchmark** the best models/providers for coding agents.
+2. Have access to the **highest quality** options and not downgrade performance or route to cheaper providers.
+3. Pass along any **price drops** by selling at cost; so the only markup is to cover our processing fees.
+4. Have **no lock-in** by allowing you to use it with any other coding agent. And always let you use any other provider with NeoCode as well.

package/src/content.config.ts

@@ -0,0 +1,7 @@
+import { defineCollection } from "astro:content"
+import { docsLoader } from "@astrojs/starlight/loaders"
+import { docsSchema } from "@astrojs/starlight/schema"
+
+export const collections = {
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+}

package/src/pages/[...slug].md.ts

@@ -0,0 +1,18 @@
+import type { APIRoute } from "astro"
+import { getCollection } from "astro:content"
+
+export const GET: APIRoute = async ({ params }) => {
+  const slug = params.slug || "index"
+  const docs = await getCollection("docs")
+  const doc = docs.find((d) => d.id === slug)
+
+  if (!doc) {
+    return new Response("Not found", { status: 404 })
+  }
+
+  return new Response(doc.body, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+    },
+  })
+}

package/src/pages/s/[id].astro

@@ -0,0 +1,113 @@
+---
+import { Base64 } from "js-base64";
+
+import config from '../../../config.mjs'
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import Share from "../../components/Share.tsx";
+
+const apiUrl = import.meta.env.VITE_API_URL;
+
+const { id } = Astro.params;
+const res = await fetch(`${apiUrl}/share_data?id=${id}`);
+const data = await res.json();
+
+if (!data.info) {
+  return new Response(null, {
+    status: 404,
+    statusText: 'Not found'
+  });
+}
+
+const models: Set<string> = new Set();
+const version = data.info.version ? `v${data.info.version}` : "v0.0.1";
+
+Object.values(data.messages).forEach((d) => {
+  if (d.role === "assistant" && d.modelID) {
+    models.add(d.modelID);
+  }
+});
+
+const encodedTitle = encodeURIComponent(
+  Base64.encode(
+    // Convert to ASCII
+    encodeURIComponent(
+      // Truncate to fit S3's max key size
+      data.info.title.substring(0, 700),
+    )
+  )
+);
+
+const modelsArray = Array.from(models);
+let modelParam;
+if (modelsArray.length === 1) {
+  modelParam = modelsArray[0];
+}
+else if (modelsArray.length === 2) {
+  modelParam = encodeURIComponent(`${modelsArray[0]} & ${modelsArray[1]}`);
+}
+else {
+  modelParam = encodeURIComponent(`${modelsArray[0]} & ${modelsArray.length - 1} others`);
+}
+
+const ogImage = `${config.socialCard}/neocode-share/${encodedTitle}.png?model=${modelParam}&version=${version}&id=${id}`;
+---
+<StarlightPage
+  hasSidebar={false}
+  frontmatter={{
+    title: data.info.title,
+    pagefind: false,
+    template: "splash",
+    tableOfContents: false,
+    head: [
+      {
+        tag: "meta",
+        attrs: {
+          name: "description",
+          content: "neocode - The AI coding agent built for the terminal.",
+        },
+      },
+      {
+        tag: "meta",
+        attrs: {
+          name: "robots",
+          content: "noindex, nofollow, noarchive, nosnippet",
+        }
+      },
+      {
+        tag: "meta",
+        attrs: {
+          property: "og:image",
+          content: ogImage,
+        },
+      },
+      {
+        tag: "meta",
+        attrs: {
+          name: "twitter:image",
+          content: ogImage,
+        },
+      },
+    ],
+  }}
+>
+  <Share
+    id={id}
+    api={apiUrl}
+    info={data.info}
+    messages={data.messages}
+    client:only="solid"
+  />
+</StarlightPage>
+
+<style is:global>
+body > .page > .main-frame .main-pane > main > .content-panel:first-of-type {
+  display: none;
+}
+body > .page > .main-frame .main-pane > main {
+  padding: 0;
+}
+body > .page > .main-frame .main-pane > main > .content-panel + .content-panel {
+  border-top: none !important;
+  padding: 0;
+}
+</style>