@moreai/code 0.0.0-stage → 0.1.0-beta.2

package/LICENSE

@@ -0,0 +1,28 @@
+More AI Code
+Copyright (c) 2026 More AI. All rights reserved.
+
+This software is proprietary. It is licensed, not sold.
+
+You may install the published package and use it to run More AI Code for your
+own work, subject to the More AI Terms of Service (https://more-ai.net/terms).
+
+You may not, except to the extent applicable law expressly permits it despite
+this restriction:
+  - copy, modify, merge, publish, distribute, sublicense or sell the software
+    or any part of it;
+  - reverse engineer, decompile, disassemble or otherwise attempt to derive
+    its source code, or extract its prompts, policies or other components for
+    use outside More AI Code;
+  - remove or alter this notice.
+
+Third-party components bundled with the software are distributed under their
+own licenses, reproduced in THIRD_PARTY_LICENSES.txt; those licenses govern
+those components only.
+
+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/README.md

@@ -1,3 +1,252 @@
-# Temporary Holding Version
+<h1 align="center">More AI Code</h1>
 
-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.
+<p align="center">
+  <b>An AI coding agent for your terminal.</b><br>
+  Your own model keys, an engine on your machine, and cloud runs when you want them.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@moreai/code"><img alt="npm" src="https://img.shields.io/npm/v/@moreai/code/beta?label=npm%20beta&color=ff7a45"></a>
+  <img alt="Node.js 22+" src="https://img.shields.io/badge/node-%E2%89%A522-339933">
+  <img alt="macOS · Linux · Windows" src="https://img.shields.io/badge/macOS%20%C2%B7%20Linux%20%C2%B7%20Windows-555">
+  <a href="https://more-ai.net"><img alt="more-ai.net" src="https://img.shields.io/badge/more--ai.net-website-111"></a>
+</p>
+
+<p align="center">
+  <img alt="More AI Code exploring a repository, editing a file, writing a test, running it and summarising the change" src="https://cdn.jsdelivr.net/npm/@moreai/code@0.1.0-beta.2/media/session.webp" width="860">
+</p>
+
+## Install
+
+```sh
+npm install -g @moreai/code
+cd your-project
+moreai
+```
+
+Requires **Node.js 22 or newer** on macOS, Linux or Windows. The first launch
+helps you connect a model; nothing else is required — no account, no desktop app.
+
+## What it does
+
+- **Works in your repository.** Reads and searches the code, edits files and
+  shows each change as a diff, runs commands and tests, keeps a checklist of
+  its own plan, and answers in plain language.
+- **Runs on your models.** About 40 providers: Anthropic, OpenAI, Google
+  Gemini, OpenRouter, DeepSeek, Groq, local models through Ollama or LM Studio,
+  any OpenAI-compatible endpoint, and ChatGPT or GitHub Copilot subscriptions.
+  Keys stay on your machine.
+- **Asks before it acts.** Five access modes, from read-only planning to full
+  autonomy. Commands run in an OS sandbox where one is available, and risky
+  ones are held for you.
+- **Splits big questions across helpers.** Parallel helper agents research
+  different parts of the codebase at once and report back.
+- **Moves work to the cloud.** With a More AI account, a task can keep running
+  on our servers with your laptop closed and come back as a branch or a pull
+  request.
+- **Listens.** `Ctrl+T` dictates into the prompt.
+- **Speaks your language.** The interface is translated into 35 languages.
+
+## Getting started
+
+```sh
+moreai            # interactive session in this folder
+moreai setup      # guided setup: model, optional account and services
+moreai auth       # connect or change an AI provider
+moreai doctor     # check that everything is ready
+```
+
+If a provider key is already in your environment (`ANTHROPIC_API_KEY`,
+`OPENAI_API_KEY`, …), the first launch offers it at the top of the list, and
+`moreai auth env` connects every one it finds.
+
+In a session, type a task and press **Enter**. While the agent works you can
+keep typing to steer it, **Esc** interrupts, and **Shift+Tab** changes the
+access mode. `/help` lists every command.
+
+## Access modes
+
+| Mode | What the agent may do |
+| --- | --- |
+| `plan` | Read the code and propose a plan for you to approve; then it builds |
+| `read-only` | Read and answer; never change anything |
+| `accept-edits` | Edit files on its own; ask before running commands |
+| `auto` *(default)* | Work on its own; anything it cannot show to be safe is declined |
+| `full` | Run everything except a small set of destructive commands |
+
+Pick one with **Shift+Tab** in a session or `--mode <mode>` on the command line.
+
+## Helper agents
+
+<p align="center">
+  <img alt="Three parallel helper agents researching webhooks, each with its result, then the combined answer" src="https://cdn.jsdelivr.net/npm/@moreai/code@0.1.0-beta.2/media/helpers.webp" width="860">
+</p>
+
+For broad questions the agent can start several **helper agents** in
+parallel. Each gets its own line — what it was asked, what it is doing now,
+and when it finishes, its tool count, tokens and time with the first line of
+its report. The run's token total shows how much of it went to helpers.
+Helpers only read; the main agent makes the changes.
+
+Start a task with `@explore`, `@scout` or `@general` to hand it to a helper
+directly:
+
+```sh
+moreai "@explore how does the billing webhook verify signatures?"
+```
+
+## Cloud sessions
+
+With a More AI account (`moreai login`), a task can run in the cloud instead
+of on this computer. You can follow it here, or answer it from the web app or
+your phone.
+
+```sh
+moreai cloud run "add tests for the parser"   # move this folder into a cloud session
+moreai --cloud "add tests for the parser"     # the same
+moreai cloud                                  # your cloud sessions and their state
+moreai cloud open <id>                        # the conversation and its link
+moreai cloud finish <id>                      # bring the work back again
+```
+
+`moreai cloud run` uploads the folder as it is — your branch, commits and
+uncommitted changes, never files that look like secrets or are over 25 MB —
+and follows the task in the terminal. **Ctrl+C** stops following; the task
+keeps running. When it finishes, the work comes back as a **new branch**
+`more-ai/<topic>-<id>`, and your own branch and edits are never touched. In a
+GitHub or GitLab repository it is pushed and a pull request is opened with
+your own `gh` / `glab` login; `--finish push|branch|folder` chooses otherwise.
+Inside a session, `/cloud` does the same.
+
+## Scripts and pipes
+
+```sh
+moreai -p "summarise the open TODOs"            # run once, print the answer, exit
+git diff | moreai -p "review this diff"
+moreai -p --json "add types to utils.ts"        # one JSON event per line
+moreai -c                                       # continue the newest session here
+moreai sessions                                 # this folder's sessions
+```
+
+| Option | Meaning |
+| --- | --- |
+| `-p, --print` | Run once without the interactive interface |
+| `--json` | With `-p`: machine-readable events, one per line |
+| `-c, --continue` | Continue this folder's newest session |
+| `--session <id>` | Resume a specific session |
+| `-m, --model <id>` | Choose the model for this run |
+| `--provider <id>` | Say which provider serves `--model` |
+| `--mode <mode>` | Access mode (see above) |
+| `-C, --cwd <dir>` | Work in another folder |
+| `--cloud` | Run the task in a cloud session |
+| `--finish <how>` | With `--cloud`: `pr`, `push`, `branch` or `folder` |
+| `--detach` | With `--cloud`: start it and return immediately |
+| `--lang <id>` | Interface language for this run |
+
+## In the session
+
+| Key | Action |
+| --- | --- |
+| Enter | Send (or steer the running task) |
+| Ctrl+J, or `\` at line end | New line |
+| Esc | Interrupt the run; twice clears the draft |
+| Shift+Tab | Change the access mode |
+| Ctrl+T | Dictate (Enter or Ctrl+T to insert, Esc to discard) |
+| ↑ ↓ | Move between lines, then through your history |
+| Ctrl+O | Expand a large paste back into editable text |
+| Ctrl+D, or Ctrl+C twice | Leave; the command to resume is printed |
+
+Useful commands: `/model` (pick a model; **Ctrl+F** pins it), `/sessions`,
+`/connectors` (Gmail, Calendar, Drive, GitHub and other services for the
+agent), `/cloud`, `/language`, `/login`, `/status`, `/help`.
+
+## Voice input
+
+**Ctrl+T** (or `/voice`) records from the microphone and puts the text at the
+cursor without sending it. Transcription uses More AI dictation once you sign
+in, your own transcription service, or an on-device model set up in the More
+AI desktop app. Recording uses the ffmpeg that comes with the desktop app, or
+`ffmpeg`, `sox`, `parecord` or `arecord` from your `PATH`.
+
+## Account and services
+
+A More AI account is optional. It adds cloud sessions, sync of your sessions to
+the web and phone apps, More AI dictation, and Google services (Gmail,
+Calendar, Drive) for the agent.
+
+```sh
+moreai login                 # sign in with your email (a code or an approval on another device)
+moreai account               # the signed-in account and plan
+moreai connectors            # connect a service; `moreai connectors list` shows them
+moreai logout                # sign out; your own provider keys stay
+```
+
+From a script or an SSH session: `moreai login you@example.com`, then pipe the
+emailed code to `moreai login you@example.com --code-stdin`. When a provider
+signs in through the browser on a remote machine, the CLI prints the
+`ssh -L` command that forwards the sign-in back to your terminal.
+
+## How it runs
+
+`moreai` starts a small background engine on your machine the first time it
+needs one; later sessions, the More AI desktop app and the VS Code extension
+share it, so a session started in one place continues in another. If the
+desktop app is running with **Settings → Agent tools → External clients** on,
+the CLI uses the app's engine instead.
+
+Provider keys are encrypted with a key kept in the system keyring (macOS
+Keychain, Windows Credential Manager, or the Secret Service on Linux). A Linux
+server without a keyring service stores them in a file only your user can read
+(`~/.config/More AI/secrets.json`), the way most command-line tools keep tokens.
+
+## Privacy
+
+Your code and keys stay on your machine unless you move a task to the cloud.
+More AI collects usage analytics to find bugs; with AI traces on (the default)
+the content of runs is included so failed runs can be debugged. API keys are
+never sent. The first interactive session asks once; change it any time:
+
+```sh
+moreai analytics off       # nothing is sent
+moreai analytics usage     # usage only, no conversation content
+moreai analytics on        # usage and AI traces
+```
+
+`DO_NOT_TRACK=1` or `MOREAI_TELEMETRY=0` turns analytics off for any process
+that sees it.
+
+## Update and uninstall
+
+```sh
+moreai update              # is there a newer version?
+moreai update --install    # install it
+npm uninstall -g @moreai/code
+```
+
+The background engine notices an update or uninstall and stops by itself once
+nothing is using it, so the next session runs the new version.
+
+Version 0.1.0-beta.1 cannot see newer versions: update it once with
+`npm install -g @moreai/code@latest`. Its engine predates the self-stop and
+keeps running until you restart the computer or run
+`pkill -f @moreai/code/dist/daemon.mjs` (macOS, Linux).
+
+## Troubleshooting
+
+- **`moreai doctor`** checks the engine, the connection and your setup, and says
+  what to fix.
+- **"No AI provider is connected"**: run `moreai auth`, or `moreai auth env` if
+  your key is in an environment variable.
+- **The desktop app is running but the CLI cannot attach**: turn on
+  **Settings → Agent tools → External clients** in the app, or close the app.
+- **Commands are held on a Linux server**: in `auto` the agent runs commands
+  on its own only inside a sandbox (bubblewrap on Linux). Without one, switch to
+  `accept-edits` (**Shift+Tab**) to approve each command, or use `--mode full`
+  in an environment you trust.
+
+Questions and bug reports: [support@more-ai.net](mailto:support@more-ai.net).
+
+## License
+
+© 2026 More AI. All rights reserved. Proprietary software — see `LICENSE`.
+The open-source components it bundles are listed in `THIRD_PARTY_LICENSES.txt`.