nexgenk 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moonshot AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,10 @@
+NexgenK
+Copyright (c) 2026 NexgenK
+
+This product is a fork of the kimi-code project, Copyright (c) 2026 Moonshot AI,
+distributed under the MIT License. The original MIT license text is reproduced
+in the LICENSE file. NexgenK replaces the original provider, authentication,
+telemetry, update, and plugin integrations with NexgenRouter
+(https://ia.nexgen.systems) and does not call Moonshot or Kimi services.
+
+Third-party dependencies remain under their own licenses.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# nexgenk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+NexgenK CLI is a terminal AI coding agent wired to **NexgenRouter**.
+
+## Install
+
+Requires Node.js 22.19.0 or later.
+
+```sh
+npm install -g nexgenk
+```
+
+Or with pnpm:
+
+```sh
+pnpm add -g nexgenk
+```
+
+## Configure
+
+NexgenK authenticates with a NexgenRouter API key:
+
+```sh
+export NEXGEN_API_KEY="<your key>"
+# optional, defaults to https://ia.nexgen.systems/v1
+export NEXGEN_BASE_URL="https://ia.nexgen.systems/v1"
+```
+
+Validate the key and provision the model catalog:
+
+```sh
+nexgenk login                       # reads NEXGEN_API_KEY
+nexgenk login --api-key <your key>  # or pass it explicitly
+```
+
+This reads `GET /v1/models`, writes `~/.nexgenk/config.toml`, and selects `nexgen-auto` as the default model.
+
+## Quick start
+
+```sh
+cd your-project
+nexgenk -p "Summarize this repository"
+nexgenk            # interactive terminal UI
+```
+
+## What it talks to
+
+| Capability | Endpoint |
+|---|---|
+| Chat (OpenAI, Responses, Anthropic) | `POST /v1/chat/completions`, `/v1/responses`, `/v1/messages` |
+| Model catalog | `GET /v1/models` |
+| Web search | `POST /v1/tools/search` |
+| URL fetch | `POST /v1/tools/fetch` |
+| Server tools | `openrouter:*` declared in `tools[]` |
+
+Authentication uses `Authorization: Bearer <key>` (and `x-api-key` on the Anthropic wire).
+
+## Features
+
+- Terminal UI, headless `-p` mode, ACP server, and a local REST/WS API (`nexgenk web`).
+- Sessions persisted under `~/.nexgenk/sessions`, with `wire.jsonl` as the source of truth.
+- Permissions and approvals with `manual`, `yolo`, and `auto` modes.
+- Agent Skills, MCP servers, subagents, goals, cron tasks, and Swarm fan-out.
+- Provider/model configuration for any OpenAI-, Anthropic-, or Gemini-compatible endpoint.
+
+## Not included in this build
+
+- Remote Control (requires a relay service).
+- CDN-based auto-update; upgrade with `npm install -g nexgenk@latest`.
+- The bundled browser UI; `nexgenk web` serves the API plus a minimal landing page.
+- Device-flow OAuth; `nexgenk login` validates an API key and writes the provider entry.
+
+## License
+
+MIT. See `LICENSE` and `NOTICE` for the upstream attribution.