@anvi-cli/anvi 1.0.0

package/LICENSE

@@ -0,0 +1,189 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 eagleisbatman
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,195 @@
+# >anvi.
+
+Terminal-native AI coding agent. Built in Rust. Powered by Gemini.
+
+Anvi is a terminal AI coding agent in the same family as Claude Code and Cursor's agent workflows, but designed as a native Rust CLI instead of a web shell wrapped in a terminal. It gives you multi-turn tool use, code editing, shell execution, sub-agent orchestration, persistent memory, and git-aware workflows with fast startup, Gemini-native defaults, and an extension model built around installable skills, MCP servers, and plugins.
+
+Anvi is built for people who want an agent that feels like part of the terminal: fast to launch, easy to script, comfortable in large repos, and extensible without rebuilding the core product.
+
+- Startup target: sub-150ms cold start
+- Model-first design: Gemini 3.x as the default provider
+- Extension surface: skills, MCP servers, plugins, templates, memory
+- Workspace model: local-first, project-aware, and git-aware
+
+See [Getting Started](docs/GETTING_STARTED.md) for a guided walkthrough, or [Roadmap](docs/ROADMAP.md) for the longer product vision.
+
+## Install
+
+```bash
+# npm (recommended)
+npm install -g @anvi-cli/anvi
+
+# Shell installer
+curl -fsSL https://raw.githubusercontent.com/eagleisbatman/anvi/main/install.sh | sh
+
+# Build from source
+cargo install --git https://github.com/eagleisbatman/anvi.git --package anvi-tui --bin anvi --force
+```
+
+## Quick Start
+
+```bash
+# Set API key
+export GEMINI_API_KEY="your-key-here"
+
+# Run
+anvi
+```
+
+If you prefer another provider, Anvi also supports `OPENAI_API_KEY` and `ANTHROPIC_API_KEY`.
+
+## Features
+
+- Multi-turn agent loop with 23+ built-in tools for files, shell, git, web, memory, and tasks
+- `/commit`, `/pr`, `/test-fix` for AI-assisted git workflows and fix-until-green loops
+- `/plan -x` for generating a plan and executing it step by step
+- `/review`, `/security`, `/architecture`, and 14 more built-in specialist agents
+- `/skills search|install|create` for browsing community skills or authoring your own
+- `/mcp browse|install|create` for adding Model Context Protocol servers
+- `/suggest` for project stack detection with skills and MCP recommendations
+- `/template` for reusable prompt templates with variable expansion
+- `/memory` for persistent memory, `#keyword` recall, and team-sharing flows
+- `/marketplace search|install|info` for unified browsing and installing skills, MCP servers, and plugins
+- Plugin system for custom tools in any language via `~/.anvi/plugins`
+- RTK integration for 60-90% token reduction on supported shell output
+- CLI-Anything integration for controlling professional desktop software from the terminal
+- `@file` mentions for prompt-time file injection and `#keyword` memory lookup
+- Progress indicators, cost tracking, context budget visibility, and session summaries
+
+## Configuration
+
+Anvi stores global config in `~/.anvi/config.toml` and can layer project-local helpers under `.anvi/`.
+
+```toml
+# ~/.anvi/config.toml
+[model]
+provider = "gemini" # gemini | openai | anthropic
+model_id = "gemini-3-flash-preview"
+
+[optimization]
+rtk_enabled = false # Install RTK and flip to true for token savings
+```
+
+Common provider environment variables:
+
+- Gemini: `GEMINI_API_KEY`
+- OpenAI: `OPENAI_API_KEY`
+- Anthropic: `ANTHROPIC_API_KEY`
+
+Useful companion settings:
+
+- `[permissions] mode = "default"` for approval behavior
+- `theme = "dark"` for terminal theme preference
+- `[[model.fallback]]` for provider/model fallback chains
+
+## Commands Quick Reference
+
+Slash commands are the main control surface inside the REPL. Specialist agents are also exposed as commands, so `/review`, `/security`, `/scaffold`, `/debug`, and friends behave like first-class built-ins.
+
+| Command | Description |
+| --- | --- |
+| `/new` | Start a fresh session in the current workspace |
+| `/sessions` | Browse and resume recent sessions interactively |
+| `/resume <id>` | Resume a specific session by thread ID |
+| `/compact` | Summarize older context to free tokens |
+| `/rewind` | Remove the last user/assistant exchange |
+| `/model [name]` | Show or switch the active model |
+| `/models` | Browse built-in model options |
+| `/cost` | Estimate current session cost from token usage |
+| `/read <path>` | Read a file into the terminal |
+| `/write <path> [content]` | Write content or open a file in `$EDITOR` |
+| `/edit <path>` | Open a file in your configured editor |
+| `/bash <cmd>` | Run a shell command through the agent runtime |
+| `/glob <pattern>` | Find files by glob pattern |
+| `/grep <pattern>` | Search repository content with regex |
+| `/plan [-x] <task>` | Generate a plan, optionally auto-execute it |
+| `/diff [--staged]` | Render the current git diff |
+| `/memory ...` | List, search, export, import, share, or prune memory |
+| `/skills ...` | List, search, install, remove, or create skills |
+| `/marketplace ...` | Search, install, and inspect skills, MCP servers, and plugins |
+| `/template ...` | Run a reusable prompt template |
+| `/commit` | Generate a conventional commit message and commit |
+| `/pr [base]` | Draft and create a GitHub pull request |
+| `/test-fix [n|--cmd ...]` | Run tests, fix failures, and retry |
+| `/undo` | Revert uncommitted changes after confirmation |
+| `/status` | Show session, environment, memory, and runtime status |
+| `/context` | Inspect context budget and compaction pressure |
+| `/tokens` | Show input, output, and total token usage |
+| `/init` | Create project-local `.anvi` helper files |
+| `/suggest` | Detect the project stack and recommend add-ons |
+| `/plugins` | List discovered external plugin tools |
+| `/theme [name]` | Show or switch the terminal theme |
+| `/login` | Configure the active provider API key |
+| `/logout` | Clear the active provider API key |
+| `/mcp ...` | Browse, install, add, create, login, or remove MCP servers |
+| `/permissions [mode]` | Change approval mode for tools and edits |
+| `/bg <prompt>` | Run a prompt as a background job |
+| `/fg [job-id]` | Show output from a finished background job |
+| `/jobs` | List background jobs |
+| `/help` | Show the full command list |
+
+Prompt shortcuts:
+
+- `@path/to/file.rs` injects a file into the next prompt
+- `@path/to/dir/` injects a directory listing
+- `#keyword` recalls matching memory entries into context
+
+## Skills & Plugins
+
+Anvi has two extension layers:
+
+- Skills are prompt-level behaviors. Built-in examples include `/review`, `/security`, `/scaffold`, `/docs`, `/debug`, and `/onboard`. Community skills can be searched and installed with `/skills search <query>` and `/skills install <name>`.
+- Plugins are executable tools discovered from `~/.anvi/plugins`. Each plugin is a trusted local binary plus a JSON manifest, so you can add custom tools in Python, shell, Ruby, or anything else that can read JSON on stdin and print JSON on stdout.
+
+Examples:
+
+```bash
+/skills search ci
+/skills install ci-pipeline
+/skills create release-notes
+```
+
+```bash
+/mcp browse
+/mcp install github
+/mcp create jira-sync
+```
+
+For hands-on setup, see [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md).
+
+## Architecture
+
+Anvi is a 6-crate Rust workspace:
+
+```text
+anvi
+├── mastra-core       shared agent/runtime types, streaming, workflows
+├── mastra-memory     SQLite-backed sessions, tasks, and memory
+├── mastra-providers  Gemini, OpenAI, and Anthropic provider adapters
+├── mastra-tools      built-in tools, plugins, MCP, RTK, CLI-Anything
+├── anvi-agent        orchestration, planning, config, skills, approvals
+└── anvi-tui          CLI binary, REPL, commands, themes, rendering
+```
+
+Rough dependency flow:
+
+```text
+anvi-tui
+   -> anvi-agent
+      -> mastra-core
+      -> mastra-memory
+      -> mastra-providers
+      -> mastra-tools
+```
+
+## Installation Notes
+
+- Requires a Rust toolchain with `cargo`
+- First run creates `~/.anvi/` automatically
+- `anvi --doctor` checks API key, provider connectivity, memory, git context, and RTK status
+- `anvi -c` resumes your most recent session
+- `anvi "prompt"` runs one-shot mode without entering the full REPL
+
+## License
+
+Apache 2.0

package/bin/anvi

@@ -0,0 +1,4 @@
+#!/bin/sh
+echo "Anvi launcher is not initialized yet."
+echo "Reinstall @anvi-cli/anvi so postinstall can wire the platform binary."
+exit 1

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@anvi-cli/anvi",
+  "version": "1.0.0",
+  "description": "Terminal-native AI coding agent built in Rust, powered by Gemini",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eagleisbatman/anvi"
+  },
+  "homepage": "https://github.com/eagleisbatman/anvi",
+  "keywords": [
+    "ai",
+    "coding",
+    "agent",
+    "terminal",
+    "cli",
+    "gemini",
+    "rust"
+  ],
+  "bin": {
+    "anvi": "bin/anvi"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@anvi-cli/anvi-darwin-arm64": "1.0.0",
+    "@anvi-cli/anvi-darwin-x64": "1.0.0",
+    "@anvi-cli/anvi-linux-x64": "1.0.0",
+    "@anvi-cli/anvi-linux-arm64": "1.0.0"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@anvi-cli/anvi-darwin-arm64",
+  "darwin-x64": "@anvi-cli/anvi-darwin-x64",
+  "linux-x64": "@anvi-cli/anvi-linux-x64",
+  "linux-arm64": "@anvi-cli/anvi-linux-arm64",
+};
+
+function main() {
+  const platform = os.platform();
+  const arch = os.arch();
+  const key = `${platform}-${arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+
+  if (!pkg) {
+    console.error(`Anvi does not support ${platform}-${arch}`);
+    process.exit(1);
+  }
+
+  let binaryPath;
+  try {
+    const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+    const binaryName = platform === "win32" ? "anvi.exe" : "anvi";
+    binaryPath = path.join(pkgDir, "bin", binaryName);
+  } catch {
+    console.error(
+      `Failed to find the Anvi binary package for ${key}.\n` +
+      `Expected package: ${pkg}\n\n` +
+      `Try reinstalling: npm install -g @anvi-cli/anvi`
+    );
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(binaryPath)) {
+    console.error(`Binary not found at ${binaryPath}`);
+    process.exit(1);
+  }
+
+  // Create a launcher script in our bin/ directory
+  const binDir = path.join(__dirname, "..", "bin");
+  fs.mkdirSync(binDir, { recursive: true });
+
+  const launcherPath = path.join(binDir, "anvi");
+
+  if (platform === "win32") {
+    // Windows: create a .cmd launcher
+    fs.writeFileSync(
+      launcherPath + ".cmd",
+      `@echo off\n"${binaryPath}" %*\n`
+    );
+  } else {
+    // Unix: create a symlink or shell wrapper
+    try {
+      if (fs.existsSync(launcherPath)) fs.unlinkSync(launcherPath);
+      fs.symlinkSync(binaryPath, launcherPath);
+    } catch {
+      // Fallback to shell wrapper if symlink fails
+      fs.writeFileSync(
+        launcherPath,
+        `#!/bin/sh\nexec "${binaryPath}" "$@"\n`
+      );
+      fs.chmodSync(launcherPath, 0o755);
+    }
+  }
+}
+
+main();