@maincode-ai/matilda-code 0.21.13 → 0.22.0-nightly.20261102.db95a17c4

package/bundled/mainy/docs/overview.md

@@ -1,64 +0,0 @@
-# Matilda Code overview
-
-[![@maincode-ai/matilda-code downloads](https://img.shields.io/npm/dw/@maincode-ai/matilda-code.svg)](https://npm-compare.com/@maincode-ai/matilda-code)
-[![@maincode-ai/matilda-code version](https://img.shields.io/npm/v/@maincode-ai/matilda-code.svg)](https://www.npmjs.com/package/@maincode-ai/matilda-code)
-
-> Learn about Matilda Code, Matilda's agentic coding tool that lives in your terminal and helps you turn ideas into code faster than ever before.
-
-## Get started in 30 seconds
-
-### Install Matilda Code:
-
-**NPM (macOS, Linux, Windows)**
-
-```sh
-npm install -g @maincode-ai/matilda-code@latest
-```
-
-> [!note]
->
-> It's recommended to restart your terminal after installation if `matilda` is not
-> immediately available on PATH. If installation fails, confirm that Node.js 22
-> or later is installed, then retry the NPM command.
-
-### Start using Matilda Code:
-
-```bash
-cd your-project
-matilda auth login
-matilda
-```
-
-`matilda auth login` opens your browser and saves a refresh token locally. No API
-key is required for interactive use. Then let's start with understanding your
-codebase. Try one of these commands:
-
-```
-what does this project do?
-```
-
-![](https://cloud.video.taobao.com/vod/j7-QtQScn8UEAaEdiv619fSkk5p-t17orpDbSqKVL5A.mp4)
-
-You'll be prompted to log in on first use. That's it! [Continue with Quickstart (5 mins) →](./quickstart)
-
-> [!tip]
->
-> See [troubleshooting](./support/troubleshooting) if you hit issues.
-
-> [!note]
->
-> **New VS Code Extension (Beta)**: Prefer a graphical interface? Our new **VS Code extension** provides an easy-to-use native IDE experience without requiring terminal familiarity. Simply install from the marketplace and start coding with Matilda Code directly in your sidebar. Download and install the [Matilda Code Companion](https://marketplace.visualstudio.com/items?itemName=maincode.matilda-code-vscode-ide-companion) now.
-
-## What Matilda Code does for you
-
-- **Build features from descriptions**: Tell Matilda Code what you want to build in plain language. It will make a plan, write the code, and ensure it works.
-- **Debug and fix issues**: Describe a bug or paste an error message. Matilda Code will analyze your codebase, identify the problem, and implement a fix.
-- **Navigate any codebase**: Ask anything about your team's codebase, and get a thoughtful answer back. Matilda Code maintains awareness of your entire project structure, can find up-to-date information from the web, and with [MCP](./features/mcp) can pull from external datasources like Google Drive, Figma, and Slack.
-- **Automate tedious tasks**: Fix fiddly lint issues, resolve merge conflicts, and write release notes. Do all this in a single command from your developer machines, or automatically in CI.
-- **[Followup suggestions](./features/followup-suggestions)**: Matilda Code predicts what you want to type next and shows it as ghost text. Press Tab to accept, or just keep typing to dismiss.
-
-## Why developers love Matilda Code
-
-- **Works in your terminal**: Not another chat window. Not another IDE. Matilda Code meets you where you already work, with the tools you already love.
-- **Takes action**: Matilda Code can directly edit files, run commands, and create commits. Need more? [MCP](./features/mcp) lets Matilda Code read your design docs in Google Drive, update your tickets in Jira, or use _your_ custom developer tooling.
-- **Unix philosophy**: Matilda Code is composable and scriptable. `tail -f app.log | matilda -p "Slack me if you see any anomalies appear in this log stream"` _works_. Your CI can run `matilda -p "If there are new text strings, translate them into French and raise a PR for @lang-fr-team to review"`.

package/bundled/mainy/docs/quickstart.md

@@ -1,234 +0,0 @@
-# Quickstart
-
-> 👏 Welcome to Matilda Code!
-
-This quickstart guide will have you using AI-powered coding assistance in just a few minutes. By the end, you'll understand how to use Matilda Code for common development tasks.
-
-## Before you begin
-
-Make sure you have:
-
-- A **terminal** or command prompt open
-- A code project to work with
-- Node.js 22 or later
-- A Matilda account (recommended), or a Matilda API token / third-party key for automation
-
-## Step 1: Install Matilda Code
-
-### Install from NPM (Recommended)
-
-```sh
-npm install -g @maincode-ai/matilda-code@latest
-```
-
-After a global install, the package prints the **exact** PATH for your npm
-prefix (often `$(npm prefix -g)/bin` — not always `~/.local/bin`). Example:
-
-```sh
-export PATH="$(npm prefix -g)/bin:$PATH"
-matilda auth login
-matilda
-```
-
-- **Site:** https://maincode.com
-- **App:** https://matilda.maincode.com
-
-For interactive use you do not need `MATILDA_API_KEY` (that is for CI/automation).  
-Inside a session, `/auth` switches account / API token / third-party providers.
-
-> [!tip]
->
-> `matilda auth status` checks sign-in; `matilda auth logout` clears it.
-
-## Step 2: Start your first session
-
-Open a project directory and run:
-
-```bash
-cd /path/to/your/project
-matilda
-```
-
-You'll see the Matilda Code welcome screen with your session information, recent conversations, and latest updates. Type `/help` for available commands.
-
-## Chat with Matilda Code
-
-### Ask your first question
-
-Matilda Code will analyze your files and provide a summary. You can also ask more specific questions:
-
-```
-explain the folder structure
-```
-
-You can also ask Matilda Code about its own capabilities:
-
-```
-what can Matilda Code do?
-```
-
-> [!note]
->
-> Matilda Code reads your files as needed - you don't have to manually add context. Matilda Code also has access to its own documentation and can answer questions about its features and capabilities.
-
-### Make your first code change
-
-Now let's make Matilda Code do some actual coding. Try a simple task:
-
-```
-add a hello world function to the main file
-```
-
-Matilda Code will:
-
-1. Find the appropriate file
-2. Show you the proposed changes
-3. Ask for your approval
-4. Make the edit
-
-> [!note]
->
-> Matilda Code always asks for permission before modifying files. You can approve individual changes or enable "Accept all" mode for a session.
-
-### Use Git with Matilda Code
-
-Matilda Code makes Git operations conversational:
-
-```
-what files have I changed?
-```
-
-```
-commit my changes with a descriptive message
-```
-
-You can also prompt for more complex Git operations:
-
-```
-create a new branch called feature/quickstart
-```
-
-```
-show me the last 5 commits
-```
-
-```
-help me resolve merge conflicts
-```
-
-### Fix a bug or add a feature
-
-Matilda Code is proficient at debugging and feature implementation.
-
-Describe what you want in natural language:
-
-```
-add input validation to the user registration form
-```
-
-Or fix existing issues:
-
-```
-there's a bug where users can submit empty forms - fix it
-```
-
-Matilda Code will:
-
-- Locate the relevant code
-- Understand the context
-- Implement a solution
-- Run tests if available
-
-### Test out other common workflows
-
-There are a number of ways to work with Matilda Code:
-
-**Refactor code**
-
-```
-refactor the authentication module to use async/await instead of callbacks
-```
-
-**Write tests**
-
-```
-write unit tests for the calculator functions
-```
-
-**Update documentation**
-
-```
-update the README with installation instructions
-```
-
-**Code review**
-
-```
-review my changes and suggest improvements
-```
-
-> [!tip]
->
-> **Remember**: Matilda Code is your AI pair programmer. Talk to it like you would a helpful colleague - describe what you want to achieve, and it will help you get there.
-
-## Essential commands
-
-Here are the most important commands for daily use:
-
-| Command               | What it does                                     | Example                       |
-| --------------------- | ------------------------------------------------ | ----------------------------- |
-| `matilda`             | start Matilda Code                               | `matilda`                     |
-| `/auth`               | Change authentication method (in session)        | `/auth`                       |
-| `/doctor`             | Check current authentication and environment     | `/doctor`                     |
-| `/help`               | Display help information for available commands  | `/help` or `/?`               |
-| `/compress`           | Replace chat history with summary to save Tokens | `/compress`                   |
-| `/clear`              | Clear terminal screen content                    | `/clear` (shortcut: `Ctrl+L`) |
-| `/theme`              | Change Matilda Code visual theme                 | `/theme`                      |
-| `/language`           | View or change language settings                 | `/language`                   |
-| → `ui [language]`     | Set UI interface language                        | `/language ui de-DE`          |
-| → `output [language]` | Set LLM output language                          | `/language output German`     |
-| `/quit`               | Exit Matilda Code immediately                    | `/quit` or `/exit`            |
-
-See the [CLI reference](./features/commands) for a complete list of commands.
-
-## Pro tips for beginners
-
-**Be specific with your requests**
-
-- Instead of: "fix the bug"
-- Try: "fix the login bug where users see a blank screen after entering wrong credentials"
-
-**Use step-by-step instructions**
-
-- Break complex tasks into steps:
-
-```
-1. create a new database table for user profiles
-2. create an API endpoint to get and update user profiles
-3. build a webpage that allows users to see and edit their information
-```
-
-**Let Matilda Code explore first**
-
-- Before making changes, let Matilda Code understand your code:
-
-```
-analyze the database schema
-```
-
-```
-build a dashboard showing products that are most frequently returned by our UK customers
-```
-
-**Save time with shortcuts**
-
-- Press `?` to see all available keyboard shortcuts
-- Use Tab for command completion
-- Press ↑ for command history
-- Type `/` to see all slash commands
-
-## Getting help
-
-- **In Matilda Code**: Type `/help` or ask "how do I..."
-- **Documentation**: You're here! Browse other guides
-- **Community**: Join our [GitHub Discussion](https://github.com/MaincodeHQ/matilda-code/discussions) for tips and support

package/bundled/mainy/docs/reference/_meta.ts

@@ -1,3 +0,0 @@
-export default {
-  'keyboard-shortcuts': 'Keyboard Shortcuts',
-};

package/bundled/mainy/docs/reference/keyboard-shortcuts.md

@@ -1,91 +0,0 @@
-# Matilda Code Keyboard Shortcuts
-
-This document lists the available keyboard shortcuts in Matilda Code.
-
-## General
-
-| Shortcut                       | Description                                                                                                                                                                                                                                                                                               |
-| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Esc`                          | Close dialogs and suggestions.                                                                                                                                                                                                                                                                            |
-| `Ctrl+C`                       | Cancel the ongoing request and clear the input. Press twice to exit the application.                                                                                                                                                                                                                      |
-| `Ctrl+D`                       | Exit the application if the input is empty. Press twice to confirm.                                                                                                                                                                                                                                       |
-| `Ctrl+L`                       | Clear the screen.                                                                                                                                                                                                                                                                                         |
-| `Ctrl+O`                       | Toggle compact mode (hide/show tool output).                                                                                                                                                                                                                                                              |
-| `Ctrl+S`                       | Allows long responses to print fully, disabling truncation. Use your terminal's scrollback to view the entire output.                                                                                                                                                                                     |
-| `Ctrl+T`                       | Expand or collapse the sticky task list (fullscreen mode).                                                                                                                                                                                                                                                |
-| `Alt/Option+S`                 | Toggle the display of tool descriptions. On macOS, the terminal must send Option as Meta.                                                                                                                                                                                                                 |
-| `Ctrl+B`                       | While a foreground shell command is running: promote it to a background task. The child keeps running, the agent's turn unblocks, and the shell appears in `/tasks` + the Background tasks dialog. No-op when no shell is executing — Ctrl+B then falls through to its prompt-area binding (cursor-left). |
-| `Alt/Option+M`                 | Toggle Markdown output between rich rendered previews and raw/source mode. On macOS, the terminal must send Option as Meta.                                                                                                                                                                               |
-| `Shift+Tab` (`Tab` on Windows) | Cycle approval modes (`plan` → `default` → `auto-edit` → `auto` → `yolo`)                                                                                                                                                                                                                                 |
-
-## Input Prompt
-
-| Shortcut                                              | Description                                                                                                                         |
-| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `!`                                                   | Toggle shell mode when the input is empty.                                                                                          |
-| `?`                                                   | Toggle keyboard shortcuts display when the input is empty.                                                                          |
-| `Ctrl+Enter` / `Cmd+Enter` / `Shift+Enter` / `Ctrl+J` | Insert a newline.                                                                                                                   |
-| `Down Arrow`                                          | Row down, then snap to end, then history next.                                                                                      |
-| `Enter`                                               | Submit the current prompt.                                                                                                          |
-| `Meta+Delete` / `Ctrl+Delete`                         | Delete the word to the right of the cursor.                                                                                         |
-| `Tab`                                                 | Autocomplete the current suggestion if one exists.                                                                                  |
-| `Up Arrow`                                            | Row up, then snap to start, then history prev.                                                                                      |
-| `Ctrl+A` / `Home`                                     | Move the cursor to the beginning of the line.                                                                                       |
-| `Ctrl+B` / `Left Arrow`                               | Move the cursor one character to the left.                                                                                          |
-| `Ctrl+C`                                              | Clear the input prompt                                                                                                              |
-| `Esc` (double press)                                  | Clear the input prompt.                                                                                                             |
-| `Ctrl+D` / `Delete`                                   | Delete the character to the right of the cursor.                                                                                    |
-| `Ctrl+E` / `End`                                      | Move the cursor to the end of the line.                                                                                             |
-| `Ctrl+F` / `Right Arrow`                              | Move the cursor one character to the right.                                                                                         |
-| `Ctrl+H` / `Backspace`                                | Delete the character to the left of the cursor.                                                                                     |
-| `Ctrl+K`                                              | Delete from the cursor to the end of the line.                                                                                      |
-| `Ctrl+Left Arrow` / `Meta+Left Arrow` / `Meta+B`      | Move the cursor one word to the left.                                                                                               |
-| `Ctrl+N`                                              | Row down, then snap to end, then history next.                                                                                      |
-| `Ctrl+P`                                              | Row up, then snap to start, then history prev.                                                                                      |
-| `Ctrl+R`                                              | Reverse search through input/shell history.                                                                                         |
-| `Ctrl+Y`                                              | Retry the last failed request.                                                                                                      |
-| `Ctrl+Right Arrow` / `Meta+Right Arrow` / `Meta+F`    | Move the cursor one word to the right.                                                                                              |
-| `Ctrl+U`                                              | Delete from the cursor to the beginning of the line.                                                                                |
-| `Ctrl+V` (Windows: `Alt+V`)                           | Paste clipboard content. If the clipboard contains an image, it will be saved and a reference to it will be inserted in the prompt. |
-| `Ctrl+W` / `Meta+Backspace` / `Ctrl+Backspace`        | Delete the word to the left of the cursor.                                                                                          |
-| `Ctrl+X` / `Meta+Enter`                               | Open the current input in an external editor.                                                                                       |
-
-## Suggestions
-
-| Shortcut        | Description                            |
-| --------------- | -------------------------------------- |
-| `Down Arrow`    | Navigate down through the suggestions. |
-| `Tab` / `Enter` | Accept the selected suggestion.        |
-| `Up Arrow`      | Navigate up through the suggestions.   |
-
-## Radio Button Select
-
-| Shortcut                      | Description                                                                                                   |
-| ----------------------------- | ------------------------------------------------------------------------------------------------------------- |
-| `Down Arrow` / `j` / `Ctrl+N` | Move selection down.                                                                                          |
-| `Enter`                       | Confirm selection.                                                                                            |
-| `Up Arrow` / `k` / `Ctrl+P`   | Move selection up.                                                                                            |
-| `1-9`                         | Select an item by its number.                                                                                 |
-| (multi-digit)                 | For items with numbers greater than 9, press the digits in quick succession to select the corresponding item. |
-
-## History scrollback
-
-Active only when `ui.useTerminalBuffer` is enabled (Settings → UI → Virtualized History). In that mode conversation history is rendered inside an in-app viewport instead of the host terminal scrollback, so the keys below replace the terminal's native scroll.
-
-| Shortcut        | Description                                          |
-| --------------- | ---------------------------------------------------- |
-| `Shift+Up`      | Scroll history up one line.                          |
-| `Shift+Down`    | Scroll history down one line.                        |
-| `PgUp`          | Scroll history up one page (viewport height).        |
-| `PgDn`          | Scroll history down one page (viewport height).      |
-| `Ctrl+Home`     | Jump to the top of the conversation.                 |
-| `Ctrl+End`      | Jump to the bottom (and re-engage live auto-follow). |
-| **Mouse wheel** | Scroll history (3 lines per tick).                   |
-
-When `ui.useTerminalBuffer` is on, the terminal forwards mouse events to matilda-code so the wheel can drive the in-app viewport. As a side effect, **native click-and-drag text selection is consumed by the program** — hold `Shift` (or `Option` on macOS Terminal / iTerm) while dragging to bypass mouse capture and select text the usual way.
-
-## IDE Integration
-
-| Shortcut | Description                       |
-| -------- | --------------------------------- |
-| `Ctrl+G` | See context CLI received from IDE |

package/bundled/mainy/docs/support/Uninstall.md

@@ -1,65 +0,0 @@
-# Uninstall
-
-Your uninstall method depends on how you installed the CLI.
-
-## Method 1: Using npx
-
-npx runs packages from a temporary cache without a permanent installation. To "uninstall" the CLI, you must clear this cache, which will remove matilda-code and any other packages previously executed with npx.
-
-The npx cache is a directory named `_npx` inside your main npm cache folder. You can find your npm cache path by running `npm config get cache`.
-
-**For macOS / Linux**
-
-```bash
-# The path is typically ~/.npm/_npx
-rm -rf "$(npm config get cache)/_npx"
-```
-
-**For Windows**
-
-_Command Prompt_
-
-```cmd
-:: The path is typically %LocalAppData%\npm-cache\_npx
-rmdir /s /q "%LocalAppData%\npm-cache\_npx"
-```
-
-_PowerShell_
-
-```powershell
-# The path is typically $env:LocalAppData\npm-cache\_npx
-Remove-Item -Path (Join-Path $env:LocalAppData "npm-cache\_npx") -Recurse -Force
-```
-
-## Method 2: Using npm (Global Install)
-
-If you installed the CLI globally (e.g. `npm install -g @maincode-ai/matilda-code`), use the `npm uninstall` command with the `-g` flag to remove it.
-
-```bash
-npm uninstall -g @maincode-ai/matilda-code
-```
-
-This command completely removes the package from your system.
-
-## Method 3: Source Install
-
-If you installed from source with `bash scripts/installation/install-matilda-code.sh`, the installer placed files in the following locations:
-
-- Runtime: `~/.local/lib/matilda-code` (the cloned and built repository)
-- Wrappers: `~/.local/bin/matilda` and `~/.local/bin/matilda-code`
-- Configuration: `~/.matilda` and/or `~/.matilda` (preserved by default)
-
-To uninstall, remove the runtime and wrapper files:
-
-```bash
-rm -rf ~/.local/lib/matilda-code
-rm -f ~/.local/bin/matilda ~/.local/bin/matilda-code
-```
-
-Then remove the PATH entry that the installer may have added to your shell profile (e.g. `~/.bashrc`, `~/.zshrc`, or `~/.config/fish/config.fish`). Look for a line referencing `~/.local/bin` and remove it if Matilda Code was the reason it was added.
-
-Your configuration and authentication files under `~/.matilda` are preserved. Remove that directory manually if you want a complete clean-up:
-
-```bash
-rm -rf ~/.matilda
-```

package/bundled/mainy/docs/support/_meta.ts

@@ -1,6 +0,0 @@
-export default {
-  troubleshooting: 'Troubleshooting',
-  'tos-privacy': 'Terms of Service',
-
-  Uninstall: 'Uninstall',
-};

package/bundled/mainy/docs/support/tos-privacy.md

@@ -1,94 +0,0 @@
-# Matilda Code: Terms of Service and Privacy Notice
-
-Matilda Code is an open-source AI coding assistant tool maintained by the Matilda Code team. This document outlines the terms of service and privacy policies that apply when using Matilda Code's authentication methods and AI model services.
-
-## How to determine your authentication method
-
-Matilda Code supports three authentication methods to access AI models. Your authentication method determines which terms of service and privacy policies apply to your usage:
-
-1. **Matilda OAuth** — Log in with your matilda.ai account (free tier discontinued 2026-04-15)
-2. **API Key** — Bring your own API key
-
-For each authentication method, different Terms of Service and Privacy Notices may apply depending on the underlying service provider.
-
-| Authentication Method | Provider          | Terms of Service                                              | Privacy Notice                                             |
-| :-------------------- | :---------------- | :------------------------------------------------------------ | :--------------------------------------------------------- |
-| Matilda OAuth         | Matilda AI        | [Matilda Terms of Service](https://matilda.ai/termsservice)   | [Matilda Privacy Policy](https://matilda.ai/privacypolicy) |
-| API Key               | Various Providers | Depends on your chosen API provider (OpenAI, Anthropic, etc.) | Depends on your chosen API provider                        |
-
-## 1. If you are using Matilda OAuth Authentication
-
-When you authenticate using your matilda.ai account, these Terms of Service and Privacy Notice documents apply:
-
-- **Terms of Service:** Your use is governed by the [Matilda Terms of Service](https://matilda.ai/termsservice).
-- **Privacy Notice:** The collection and use of your data is described in the [Matilda Privacy Policy](https://matilda.ai/privacypolicy).
-
-For details about authentication setup, quotas, and supported features, see [Authentication Setup](../configuration/settings).
-
-> [!important]
-
-## 3. If you are using your own API Key
-
-When you authenticate using API keys from other providers, the applicable Terms of Service and Privacy Notice depend on your chosen provider.
-
-> [!important]
->
-> When using your own API key, you are subject to the terms and privacy policies of your chosen API provider, not Matilda Code's terms. Please review your provider's documentation for specific details about data usage, retention, and privacy practices.
-
-Matilda Code supports various OpenAI-compatible providers. Please refer to your specific provider's terms of service and privacy policy for detailed information.
-
-## Usage Statistics and Telemetry
-
-Matilda Code may collect anonymous usage statistics and [telemetry](../../developers/development/telemetry) data to improve the user experience and product quality. This data collection is optional and can be controlled through configuration settings.
-
-### What Data is Collected
-
-When enabled, Matilda Code may collect:
-
-- Anonymous usage statistics (commands run, performance metrics)
-- Error reports and crash data
-- Feature usage patterns
-
-### Data Collection by Authentication Method
-
-- **Matilda OAuth:** Usage statistics are governed by Matilda's privacy policy. You can opt-out through Matilda Code's configuration settings.
-- **API Key:** No additional data is collected by Matilda Code beyond what your chosen API provider collects.
-
-## Frequently Asked Questions (FAQ)
-
-### 1. Is my code, including prompts and answers, used to train AI models?
-
-Whether your code, including prompts and answers, is used to train AI models depends on your authentication method and the specific AI service provider you use:
-
-- **Matilda OAuth**: Data usage is governed by [Matilda's Privacy Policy](https://matilda.ai/privacy). Please refer to their policy for specific details about data collection and model training practices.
-
-- **API Key**: Data usage depends entirely on your chosen API provider. Each provider has their own data usage policies. Please review the privacy policy and terms of service of your specific provider.
-
-**Important**: Matilda Code itself does not use your prompts, code, or responses for model training. Any data usage for training purposes would be governed by the policies of the AI service provider you authenticate with.
-
-### 2. What are Usage Statistics and what does the opt-out control?
-
-The **Usage Statistics** setting controls optional data collection by Matilda Code for improving the user experience and product quality.
-
-When enabled, Matilda Code may collect:
-
-- Anonymous telemetry (commands run, performance metrics, feature usage)
-- Error reports and crash data
-- General usage patterns
-
-**What is NOT collected by Matilda Code:**
-
-- Your code content
-- Prompts sent to AI models
-- Responses from AI models
-- Personal information
-
-The Usage Statistics setting only controls data collection by Matilda Code itself. It does not affect what data your chosen AI service provider (Matilda, OpenAI, etc.) may collect according to their own privacy policies.
-
-### 3. How do I switch between authentication methods?
-
-1. **During startup**: Choose your preferred authentication method when prompted
-2. **Within the CLI**: Use the `/auth` command to reconfigure your authentication method
-3. **Environment variables**: Set up `.env` files for automatic API key authentication
-
-For detailed instructions, see the [Authentication Setup](../configuration/settings#environment-variables-for-api-access) documentation.