@mragentix/cli 4.2.37

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KenKai
+
+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/README.md

@@ -0,0 +1,149 @@
+# @mragentix/cli
+
+<p align="center">
+  <strong>The fast, lean coding agent. Four providers. Zero bloat.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@mragentix/cli"><img src="https://img.shields.io/npm/v/@mragentix/cli?style=for-the-badge" alt="npm version"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+</p>
+
+The CLI that sits on top of the [MR Agentix Framework](../../README.md). Built on [`@mragentix/ai`](../ai/README.md) and [`@mragentix/agent`](../agent/README.md).
+
+---
+
+## Install
+
+```bash
+npm i -g @mragentix/cli
+```
+
+---
+
+## Getting started
+
+```bash
+mragentix login    # Pick provider, authenticate
+mragentix          # Start coding
+```
+
+OAuth for Anthropic and OpenAI (log in once, auto-refresh). API keys for GLM and Moonshot. Up and running in seconds either way.
+
+---
+
+## The system prompt problem
+
+Every token in the system prompt gets processed on **every single turn**. It's not a one-time cost. It's a tax on every request.
+
+| | **Claude Code / Agent SDK** | **MR Agentix Coder** |
+|---|---|---|
+| System prompt size | ~15,000 tokens | **~1,100 tokens** |
+| Ratio | baseline | **~13x smaller** |
+
+### Why you should care
+
+- **Slower responses.** More input tokens = longer time-to-first-token. In a 30-turn session, that wait adds up to minutes.
+- **Worse instruction following.** More rules = more things the model ignores. "Lost in the middle" is well-documented. A 1,100 token prompt gets read. A 15,000 token one gets skimmed.
+- **Context fills up faster.** ~15,000 tokens sitting in your window permanently. That's ~7.5% of a 200K model gone before you say hello. You hit compaction sooner, lose history faster, and the agent forgets what it was doing.
+- **Higher cost.** Input tokens aren't free. Every cache miss charges you for the full bloat. Smaller prompt = smaller bill.
+
+MR Agentix Coder sends only what the model needs: how to work, what tools it has, and your project context. No walls of rules. No formatting instructions. Just signal.
+
+---
+
+## The MCP problem
+
+Same philosophy applies to tools. People collect MCPs like Pokemon. Slack MCP, GitHub MCP, Notion MCP, five different file system MCPs. Every single one injects its tool descriptions into the context. The model now has to figure out which of 40+ tools to use for any given task.
+
+This doesn't help. It confuses the agent. More tool descriptions = more noise = worse tool selection. The model spends tokens reasoning about tools it will never call.
+
+MR Agentix Coder ships with one MCP: [Grep](https://grep.dev). That's it. It lets the agent search across 1M+ public GitHub repos to verify implementations against real-world code. Correct API usage, library idioms, production patterns. One tool that actually makes the output better.
+
+You can still add your own MCPs if you need them. But start with less. You'll get better results.
+
+---
+
+## Four providers, one agent
+
+Switch mid-conversation with `/model`. Not locked to anyone.
+
+| Provider | Models | Auth |
+|---|---|---|
+| **Anthropic** | Claude Opus 4.6, Sonnet 4.6, Haiku 4.5 | OAuth |
+| **OpenAI** | GPT-4.1, o3, o4-mini | OAuth |
+| **Z.AI (GLM)** | GLM-5, GLM-4.7 | API key |
+| **Moonshot** | Kimi K2.5 | API key |
+
+---
+
+## Slash commands
+
+Everything runs through slash commands inside the session. Not CLI flags.
+
+```bash
+/model claude-opus-4-6       # Switch models on the fly
+/model kimi-k2.5
+/compact                      # Compress context when it gets long
+
+# Built-in workflows
+/scan          # Dead code, bugs, security issues (5 parallel agents)
+/verify        # Verify against docs and best practices (8 parallel agents)
+/research      # Research best tools and patterns for your stack
+/init          # Generate CLAUDE.md for your project
+/setup-lint    # Generate a /fix command for your stack
+/setup-commit  # Generate a /commit command with quality checks
+/setup-tests   # Set up testing + generate /test
+/setup-update  # Generate an /update command for deps
+```
+
+---
+
+## Custom commands
+
+Drop a markdown file in `.mragentix/commands/` and it becomes a slash command. Your React app gets `/deploy` and `/storybook`. Your API gets `/migrate` and `/seed`. Different projects, different commands.
+
+---
+
+## Skills
+
+Reusable behaviors across projects. Drop `.md` files in:
+
+- `~/.mragentix/skills/` for global skills (available everywhere)
+- `.mragentix/skills/` for project-specific skills
+
+They get loaded into the system prompt automatically. The agent knows what it can do without you explaining it each session.
+
+---
+
+## Project guidelines
+
+Drop a `CLAUDE.md` or `AGENTS.md` in your repo root (or any parent directory). MR Agentix Coder picks it up automatically.
+
+Your rules. Your conventions. The agent follows them.
+
+---
+
+## Tools
+
+MR Agentix Coder comes with a focused set of tools:
+
+| Tool | What it does |
+|---|---|
+| `bash` | Run shell commands |
+| `read` | Read file contents |
+| `write` | Write files |
+| `edit` | Surgical string replacements |
+| `grep` | Search file contents (regex) |
+| `find` | Find files by glob pattern |
+| `ls` | List directory contents |
+| `web_fetch` | Fetch URL content |
+| `subagent` | Spawn parallel sub-agents |
+
+Plus the [Grep MCP](https://grep.dev) for searching across 1M+ public GitHub repos.
+
+---
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}