@neocode-ai/web 1.1.1

package/src/content/docs/custom-tools.mdx

@@ -0,0 +1,170 @@
+---
+title: Custom Tools
+description: Create tools the LLM can call in neocode.
+---
+
+Custom tools are functions you create that the LLM can call during conversations. They work alongside neocode's [built-in tools](/docs/tools) like `read`, `write`, and `bash`.
+
+---
+
+## Creating a tool
+
+Tools are defined as **TypeScript** or **JavaScript** files. However, the tool definition can invoke scripts written in **any language** — TypeScript or JavaScript is only used for the tool definition itself.
+
+---
+
+### Location
+
+They can be defined:
+
+- Locally by placing them in the `.neocode/tools/` directory of your project.
+- Or globally, by placing them in `~/.config/neocode/tools/`.
+
+---
+
+### Structure
+
+The easiest way to create tools is using the `tool()` helper which provides type-safety and validation.
+
+```ts title=".neocode/tools/database.ts" {1}
+import { tool } from "@neocode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    // Your database logic here
+    return `Executed query: ${args.query}`
+  },
+})
+```
+
+The **filename** becomes the **tool name**. The above creates a `database` tool.
+
+---
+
+#### Multiple tools per file
+
+You can also export multiple tools from a single file. Each export becomes **a separate tool** with the name **`<filename>_<exportname>`**:
+
+```ts title=".neocode/tools/math.ts"
+import { tool } from "@neocode-ai/plugin"
+
+export const add = tool({
+  description: "Add two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a + args.b
+  },
+})
+
+export const multiply = tool({
+  description: "Multiply two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a * args.b
+  },
+})
+```
+
+This creates two tools: `math_add` and `math_multiply`.
+
+---
+
+### Arguments
+
+You can use `tool.schema`, which is just [Zod](https://zod.dev), to define argument types.
+
+```ts "tool.schema"
+args: {
+  query: tool.schema.string().describe("SQL query to execute")
+}
+```
+
+You can also import [Zod](https://zod.dev) directly and return a plain object:
+
+```ts {6}
+import { z } from "zod"
+
+export default {
+  description: "Tool description",
+  args: {
+    param: z.string().describe("Parameter description"),
+  },
+  async execute(args, context) {
+    // Tool implementation
+    return "result"
+  },
+}
+```
+
+---
+
+### Context
+
+Tools receive context about the current session:
+
+```ts title=".neocode/tools/project.ts" {8}
+import { tool } from "@neocode-ai/plugin"
+
+export default tool({
+  description: "Get project information",
+  args: {},
+  async execute(args, context) {
+    // Access context information
+    const { agent, sessionID, messageID, directory, worktree } = context
+    return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
+  },
+})
+```
+
+Use `context.directory` for the session working directory.
+Use `context.worktree` for the git worktree root.
+
+---
+
+## Examples
+
+### Write a tool in Python
+
+You can write your tools in any language you want. Here's an example that adds two numbers using Python.
+
+First, create the tool as a Python script:
+
+```python title=".neocode/tools/add.py"
+import sys
+
+a = int(sys.argv[1])
+b = int(sys.argv[2])
+print(a + b)
+```
+
+Then create the tool definition that invokes it:
+
+```ts title=".neocode/tools/python-add.ts" {10}
+import { tool } from "@neocode-ai/plugin"
+import path from "path"
+
+export default tool({
+  description: "Add two numbers using Python",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args, context) {
+    const script = path.join(context.worktree, ".neocode/tools/add.py")
+    const result = await Bun.$`python3 ${script} ${args.a} ${args.b}`.text()
+    return result.trim()
+  },
+})
+```
+
+Here we are using the [`Bun.$`](https://bun.com/docs/runtime/shell) utility to run the Python script.

package/src/content/docs/ecosystem.mdx

@@ -0,0 +1,76 @@
+---
+title: Ecosystem
+description: Projects and integrations built with NeoCode.
+---
+
+A collection of community projects built on NeoCode.
+
+:::note
+Want to add your NeoCode related project to this list? Submit a PR.
+:::
+
+You can also check out [awesome-neocode](https://github.com/awesome-neocode/awesome-neocode) and [neocode.cafe](https://neocode.cafe), a community that aggregates the ecosystem and community.
+
+---
+
+## Plugins
+
+| Name                                                                                                    | Description                                                                                      |
+| ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| [neocode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/neocode/README.md) | Automatically run NeoCode sessions in isolated Daytona sandboxes with git sync and live previews |
+| [neocode-helicone-session](https://github.com/H2Shami/neocode-helicone-session)                         | Automatically inject Helicone session headers for request grouping                               |
+| [neocode-type-inject](https://github.com/nick-vi/neocode-type-inject)                                   | Auto-inject TypeScript/Svelte types into file reads with lookup tools                            |
+| [neocode-openai-codex-auth](https://github.com/numman-ali/neocode-openai-codex-auth)                    | Use your ChatGPT Plus/Pro subscription instead of API credits                                    |
+| [neocode-gemini-auth](https://github.com/jenslys/neocode-gemini-auth)                                   | Use your existing Gemini plan instead of API billing                                             |
+| [neocode-antigravity-auth](https://github.com/NoeFabris/neocode-antigravity-auth)                       | Use Antigravity's free models instead of API billing                                             |
+| [neocode-devcontainers](https://github.com/athal7/neocode-devcontainers)                                | Multi-branch devcontainer isolation with shallow clones and auto-assigned ports                  |
+| [neocode-google-antigravity-auth](https://github.com/shekohex/neocode-google-antigravity-auth)          | Google Antigravity OAuth Plugin, with support for Google Search, and more robust API handling    |
+| [neocode-dynamic-context-pruning](https://github.com/Tarquinen/neocode-dynamic-context-pruning)         | Optimize token usage by pruning obsolete tool outputs                                            |
+| [neocode-websearch-cited](https://github.com/ghoulr/neocode-websearch-cited.git)                        | Add native websearch support for supported providers with Google grounded style                  |
+| [neocode-pty](https://github.com/shekohex/neocode-pty.git)                                              | Enables AI agents to run background processes in a PTY, send interactive input to them.          |
+| [neocode-shell-strategy](https://github.com/JRedeker/neocode-shell-strategy)                            | Instructions for non-interactive shell commands - prevents hangs from TTY-dependent operations   |
+| [neocode-wakatime](https://github.com/angristan/neocode-wakatime)                                       | Track NeoCode usage with Wakatime                                                                |
+| [neocode-md-table-formatter](https://github.com/franlol/neocode-md-table-formatter/tree/main)           | Clean up markdown tables produced by LLMs                                                        |
+| [neocode-morph-fast-apply](https://github.com/JRedeker/neocode-morph-fast-apply)                        | 10x faster code editing with Morph Fast Apply API and lazy edit markers                          |
+| [oh-my-neocode](https://github.com/code-yeongyu/oh-my-neocode)                                          | Background agents, pre-built LSP/AST/MCP tools, curated agents, Claude Code compatible           |
+| [neocode-notificator](https://github.com/panta82/neocode-notificator)                                   | Desktop notifications and sound alerts for NeoCode sessions                                      |
+| [neocode-notifier](https://github.com/mohak34/neocode-notifier)                                         | Desktop notifications and sound alerts for permission, completion, and error events              |
+| [neocode-zellij-namer](https://github.com/24601/neocode-zellij-namer)                                   | AI-powered automatic Zellij session naming based on NeoCode context                              |
+| [neocode-skillful](https://github.com/zenobi-us/neocode-skillful)                                       | Allow NeoCode agents to lazy load prompts on demand with skill discovery and injection           |
+| [neocode-supermemory](https://github.com/supermemoryai/neocode-supermemory)                             | Persistent memory across sessions using Supermemory                                              |
+| [@plannotator/neocode](https://github.com/backnotprop/plannotator/tree/main/apps/neocode-plugin)        | Interactive plan review with visual annotation and private/offline sharing                       |
+| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2)                                   | Extend neocode /commands into a powerful orchestration system with granular flow control         |
+| [neocode-scheduler](https://github.com/different-ai/neocode-scheduler)                                  | Schedule recurring jobs using launchd (Mac) or systemd (Linux) with cron syntax                  |
+| [micode](https://github.com/vtemian/micode)                                                             | Structured Brainstorm → Plan → Implement workflow with session continuity                        |
+| [octto](https://github.com/vtemian/octto)                                                               | Interactive browser UI for AI brainstorming with multi-question forms                            |
+| [neocode-background-agents](https://github.com/kdcokenny/neocode-background-agents)                     | Claude Code-style background agents with async delegation and context persistence                |
+| [neocode-notify](https://github.com/kdcokenny/neocode-notify)                                           | Native OS notifications for NeoCode – know when tasks complete                                   |
+| [neocode-workspace](https://github.com/kdcokenny/neocode-workspace)                                     | Bundled multi-agent orchestration harness – 16 components, one install                           |
+| [neocode-worktree](https://github.com/kdcokenny/neocode-worktree)                                       | Zero-friction git worktrees for NeoCode                                                          |
+
+---
+
+## Projects
+
+| Name                                                                                     | Description                                                     |
+| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
+| [kimaki](https://github.com/remorses/kimaki)                                             | Discord bot to control NeoCode sessions, built on the SDK       |
+| [neocode.nvim](https://github.com/NickvanDyke/neocode.nvim)                              | Neovim plugin for editor-aware prompts, built on the API        |
+| [portal](https://github.com/hosenur/portal)                                              | Mobile-first web UI for NeoCode over Tailscale/VPN              |
+| [neocode plugin template](https://github.com/zenobi-us/neocode-plugin-template/)         | Template for building NeoCode plugins                           |
+| [neocode.nvim](https://github.com/sudo-tee/neocode.nvim)                                 | Neovim frontend for neocode - a terminal-based AI coding agent  |
+| [ai-sdk-provider-neocode-sdk](https://github.com/ben-vargas/ai-sdk-provider-neocode-sdk) | Vercel AI SDK provider for using NeoCode via @neocode-ai/sdk    |
+| [OpenChamber](https://github.com/btriapitsyn/openchamber)                                | Web / Desktop App and VS Code Extension for NeoCode             |
+| [NeoCode-Obsidian](https://github.com/mtymek/neocode-obsidian)                           | Obsidian plugin that embedds NeoCode in Obsidian's UI           |
+| [OpenWork](https://github.com/different-ai/openwork)                                     | An open-source alternative to Claude Cowork, powered by NeoCode |
+| [ocx](https://github.com/kdcokenny/ocx)                                                  | NeoCode extension manager with portable, isolated profiles.     |
+| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad)                                 | Desktop, Web, Mobile and Remote Client App for NeoCode          |
+
+---
+
+## Agents
+
+| Name                                                            | Description                                                  |
+| --------------------------------------------------------------- | ------------------------------------------------------------ |
+| [Agentic](https://github.com/Cluster444/agentic)                | Modular AI agents and commands for structured development    |
+| [neocode-agents](https://github.com/darrenhinde/neocode-agents) | Configs, prompts, agents, and plugins for enhanced workflows |

package/src/content/docs/enterprise.mdx

@@ -0,0 +1,170 @@
+---
+title: Enterprise
+description: Using NeoCode securely in your organization.
+---
+
+import config from "../../../config.mjs"
+export const email = `mailto:${config.email}`
+
+NeoCode Enterprise is for organizations that want to ensure that their code and data never leaves their infrastructure. It can do this by using a centralized config that integrates with your SSO and internal AI gateway.
+
+:::note
+NeoCode does not store any of your code or context data.
+:::
+
+To get started with NeoCode Enterprise:
+
+1. Do a trial internally with your team.
+2. **<a href={email}>Contact us</a>** to discuss pricing and implementation options.
+
+---
+
+## Trial
+
+NeoCode is open source and does not store any of your code or context data, so your developers can simply [get started](/docs/) and carry out a trial.
+
+---
+
+### Data handling
+
+**NeoCode does not store your code or context data.** All processing happens locally or through direct API calls to your AI provider.
+
+This means that as long as you are using a provider you trust, or an internal
+AI gateway, you can use NeoCode securely.
+
+The only caveat here is the optional `/share` feature.
+
+---
+
+#### Sharing conversations
+
+If a user enables the `/share` feature, the conversation and the data associated with it are sent to the service we use to host these share pages at neo.khulnasoft.com.
+
+The data is currently served through our CDN's edge network, and is cached on the edge near your users.
+
+We recommend you disable this for your trial.
+
+```json title="neocode.json"
+{
+  "$schema": "https://neo.khulnasoft.com/config.json",
+  "share": "disabled"
+}
+```
+
+[Learn more about sharing](/docs/share).
+
+---
+
+### Code ownership
+
+**You own all code produced by NeoCode.** There are no licensing restrictions or ownership claims.
+
+---
+
+## Pricing
+
+We use a per-seat model for NeoCode Enterprise. If you have your own LLM gateway, we do not charge for tokens used. For further details about pricing and implementation options, **<a href={email}>contact us</a>**.
+
+---
+
+## Deployment
+
+Once you have completed your trial and you are ready to use NeoCode at
+your organization, you can **<a href={email}>contact us</a>** to discuss
+pricing and implementation options.
+
+---
+
+### Central Config
+
+We can set up NeoCode to use a single central config for your entire organization.
+
+This centralized config can integrate with your SSO provider and ensures all users access only your internal AI gateway.
+
+---
+
+### SSO integration
+
+Through the central config, NeoCode can integrate with your organization's SSO provider for authentication.
+
+This allows NeoCode to obtain credentials for your internal AI gateway through your existing identity management system.
+
+---
+
+### Internal AI gateway
+
+With the central config, NeoCode can also be configured to use only your internal AI gateway.
+
+You can also disable all other AI providers, ensuring all requests go through your organization's approved infrastructure.
+
+---
+
+### Self-hosting
+
+While we recommend disabling the share pages to ensure your data never leaves
+your organization, we can also help you self-host them on your infrastructure.
+
+This is currently on our roadmap. If you're interested, **<a href={email}>let us know</a>**.
+
+---
+
+## FAQ
+
+<details>
+<summary>What is NeoCode Enterprise?</summary>
+
+NeoCode Enterprise is for organizations that want to ensure that their code and data never leaves their infrastructure. It can do this by using a centralized config that integrates with your SSO and internal AI gateway.
+
+</details>
+
+<details>
+<summary>How do I get started with NeoCode Enterprise?</summary>
+
+Simply start with an internal trial with your team. NeoCode by default does not store your code or context data, making it easy to get started.
+
+Then **<a href={email}>contact us</a>** to discuss pricing and implementation options.
+
+</details>
+
+<details>
+<summary>How does enterprise pricing work?</summary>
+
+We offer per-seat enterprise pricing. If you have your own LLM gateway, we do not charge for tokens used. For further details, **<a href={email}>contact us</a>** for a custom quote based on your organization's needs.
+
+</details>
+
+<details>
+<summary>Is my data secure with NeoCode Enterprise?</summary>
+
+Yes. NeoCode does not store your code or context data. All processing happens locally or through direct API calls to your AI provider. With central config and SSO integration, your data remains secure within your organization's infrastructure.
+
+</details>
+
+<details>
+<summary>Can we use our own private NPM registry?</summary>
+
+NeoCode supports private npm registries through Bun's native `.npmrc` file support. If your organization uses a private registry, such as JFrog Artifactory, Nexus, or similar, ensure developers are authenticated before running NeoCode.
+
+To set up authentication with your private registry:
+
+```bash
+npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+```
+
+This creates `~/.npmrc` with authentication details. NeoCode will automatically
+pick this up.
+
+:::caution
+You must be logged into the private registry before running NeoCode.
+:::
+
+Alternatively, you can manually configure a `.npmrc` file:
+
+```bash title="~/.npmrc"
+registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+//your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN}
+```
+
+Developers must be logged into the private registry before running NeoCode to ensure packages can be installed from your enterprise registry.
+
+</details>

package/src/content/docs/formatters.mdx

@@ -0,0 +1,130 @@
+---
+title: Formatters
+description: NeoCode uses language specific formatters.
+---
+
+NeoCode automatically formats files after they are written or edited using language-specific formatters. This ensures that the code that is generated follows the code styles of your project.
+
+---
+
+## Built-in
+
+NeoCode comes with several built-in formatters for popular languages and frameworks. Below is a list of the formatters, supported file extensions, and commands or config options it needs.
+
+| Formatter            | Extensions                                                                                               | Requirements                                                                                          |
+| -------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| gofmt                | .go                                                                                                      | `gofmt` command available                                                                             |
+| mix                  | .ex, .exs, .eex, .heex, .leex, .neex, .sface                                                             | `mix` command available                                                                               |
+| prettier             | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and [more](https://prettier.io/docs/en/index.html) | `prettier` dependency in `package.json`                                                               |
+| biome                | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, and [more](https://biomejs.dev/)                   | `biome.json(c)` config file                                                                           |
+| zig                  | .zig, .zon                                                                                               | `zig` command available                                                                               |
+| clang-format         | .c, .cpp, .h, .hpp, .ino, and [more](https://clang.llvm.org/docs/ClangFormat.html)                       | `.clang-format` config file                                                                           |
+| ktlint               | .kt, .kts                                                                                                | `ktlint` command available                                                                            |
+| ruff                 | .py, .pyi                                                                                                | `ruff` command available with config                                                                  |
+| rustfmt              | .rs                                                                                                      | `rustfmt` command available                                                                           |
+| cargofmt             | .rs                                                                                                      | `cargo fmt` command available                                                                         |
+| uv                   | .py, .pyi                                                                                                | `uv` command available                                                                                |
+| rubocop              | .rb, .rake, .gemspec, .ru                                                                                | `rubocop` command available                                                                           |
+| standardrb           | .rb, .rake, .gemspec, .ru                                                                                | `standardrb` command available                                                                        |
+| htmlbeautifier       | .erb, .html.erb                                                                                          | `htmlbeautifier` command available                                                                    |
+| air                  | .R                                                                                                       | `air` command available                                                                               |
+| dart                 | .dart                                                                                                    | `dart` command available                                                                              |
+| ocamlformat          | .ml, .mli                                                                                                | `ocamlformat` command available and `.ocamlformat` config file                                        |
+| terraform            | .tf, .tfvars                                                                                             | `terraform` command available                                                                         |
+| gleam                | .gleam                                                                                                   | `gleam` command available                                                                             |
+| nixfmt               | .nix                                                                                                     | `nixfmt` command available                                                                            |
+| shfmt                | .sh, .bash                                                                                               | `shfmt` command available                                                                             |
+| pint                 | .php                                                                                                     | `laravel/pint` dependency in `composer.json`                                                          |
+| oxfmt (Experimental) | .js, .jsx, .ts, .tsx                                                                                     | `oxfmt` dependency in `package.json` and an [experimental env variable flag](/docs/cli/#experimental) |
+| ormolu               | .hs                                                                                                      | `ormolu` command available                                                                            |
+
+So if your project has `prettier` in your `package.json`, NeoCode will automatically use it.
+
+---
+
+## How it works
+
+When NeoCode writes or edits a file, it:
+
+1. Checks the file extension against all enabled formatters.
+2. Runs the appropriate formatter command on the file.
+3. Applies the formatting changes automatically.
+
+This process happens in the background, ensuring your code styles are maintained without any manual steps.
+
+---
+
+## Configure
+
+You can customize formatters through the `formatter` section in your NeoCode config.
+
+```json title="neocode.json"
+{
+  "$schema": "https://neo.khulnasoft.com/config.json",
+  "formatter": {}
+}
+```
+
+Each formatter configuration supports the following:
+
+| Property      | Type     | Description                                             |
+| ------------- | -------- | ------------------------------------------------------- |
+| `disabled`    | boolean  | Set this to `true` to disable the formatter             |
+| `command`     | string[] | The command to run for formatting                       |
+| `environment` | object   | Environment variables to set when running the formatter |
+| `extensions`  | string[] | File extensions this formatter should handle            |
+
+Let's look at some examples.
+
+---
+
+### Disabling formatters
+
+To disable **all** formatters globally, set `formatter` to `false`:
+
+```json title="neocode.json" {3}
+{
+  "$schema": "https://neo.khulnasoft.com/config.json",
+  "formatter": false
+}
+```
+
+To disable a **specific** formatter, set `disabled` to `true`:
+
+```json title="neocode.json" {5}
+{
+  "$schema": "https://neo.khulnasoft.com/config.json",
+  "formatter": {
+    "prettier": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### Custom formatters
+
+You can override the built-in formatters or add new ones by specifying the command, environment variables, and file extensions:
+
+```json title="neocode.json" {4-14}
+{
+  "$schema": "https://neo.khulnasoft.com/config.json",
+  "formatter": {
+    "prettier": {
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "environment": {
+        "NODE_ENV": "development"
+      },
+      "extensions": [".js", ".ts", ".jsx", ".tsx"]
+    },
+    "custom-markdown-formatter": {
+      "command": ["deno", "fmt", "$FILE"],
+      "extensions": [".md"]
+    }
+  }
+}
+```
+
+The **`$FILE` placeholder** in the command will be replaced with the path to the file being formatted.