Agent Scripts CLI
Wrappers mvn-lite, npm-lite and go-lite compress build and test output so agents spend less context on logs, plus utilities
- 118 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The utilities run builds and tests, Chrome and processes on your machine, and slopstop can stop services
Install
- Works in
Manual install
curl -fsSL https://raw.githubusercontent.com/ejboy/agent-scripts/main/install.sh | bashInstalls the repository to ~/.local/share/agent-scripts and links four commands. Add the scripts directory to PATH yourself; skills install separately.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The utilities run builds and tests, Chrome and processes on your machine, and slopstop can stop services
This is third-party code. Review the repository files before installing.
What it does
Agent Scripts is a collection of small local command-line utilities for AI-assisted development. The main three, `mvn-lite`, `npm-lite` and `go-lite`, run Maven, npm and `go test` and print one short line on success instead of a long log, while keeping the full log on failure. The author cites output reductions up to 99.99% on supported scenarios. There are more utilities. `html-screenshot` renders a PNG from a local page or URL through headless Chrome, `launch-browser` starts Chrome with DevTools debugging on, `vscode-test` runs fixed operations for testing VS Code extensions, `repolink` keeps a local registry of repositories and commands, and `slopstop` on macOS finds forgotten Colima, Gradle and mvnd processes and optionally stops the safe ones. The skills `lite-tools`, `repolink` and the experimental `lightweight-monitoring` are installed separately and teach an agent to use these commands. The installer puts the repository in `~/.local/share/agent-scripts` and links the four core commands into `~/.local/bin`.
Who it is for. Java, Node and Go developers whose agent floods context with build and test logs, and anyone who needs screenshots and VS Code extension tests from a command line.
Good fit when
- An agent runs `mvn clean verify` at every step and the successful output eats the context: `mvn-lite clean verify`
- Go tests run often and the detailed log matters only on failure: `go-lite test ./...`
- You need a screenshot of a local page with no persistent browser: `html-screenshot --width 1440 page.html`
- A Mac has piled up forgotten Gradle and Colima processes and you want to stop them after a check
Not a fit when
- You need a replacement for Maven or a build system: the author calls `mvn-lite` an incomplete replacement
- You need Windows or Linux utilities: `slopstop` and `launch-browser` target macOS
- You need full browser automation: `launch-browser` and `html-screenshot` only start Chrome and take a snapshot
Example request
Run mvn-lite clean verify and report only the result, showing the full log on failure.Limitations
The project is small and experimental. `mvn-lite` does not fully replace Maven, `npm-lite` shortens output only for two supported npm workflows and direct Node test runs while other calls pass through unchanged. `launch-browser`, `slopstop` and `vscode-test` target macOS. `slopstop` is read-only by default, and `--stop-safe` stops safe processes without asking. The `curl | bash` installer does not edit shell startup files, but you must add the `scripts/` directory to PATH yourself.
How to disable. Delete the ~/.local/share/agent-scripts directory and the links to the four commands from ~/.local/bin. Remove the export PATH line from your shell profile and the data in ~/.agent-scripts by hand, and remove the skills from the agent's skills directory.
FAQ
How do I install Agent Scripts?
Run `curl -fsSL https://raw.githubusercontent.com/ejboy/agent-scripts/main/install.sh | bash`. The repository lands in `~/.local/share/agent-scripts` and the four core commands get links in `~/.local/bin`. Manually: `git clone` into that folder and `export PATH`.
Does the same installer add the skills?
No. The installer adds commands only and does not call the Skills CLI. The `lite-tools`, `repolink` and experimental `lightweight-monitoring` skills install separately per the repository's instructions.
What does mvn-lite print on a failure?
It keeps the full log and shows a short summary. The `--full` flag turns compression off: `mvn-lite --full dependency:tree`. `go-lite --full test ./...` works the same way.
Is slopstop safe to run?
By default it only reads and lists candidates. `--stop` asks for confirmation once, `--stop-safe` stops safe ones without asking but rechecks each. Old or resource-heavy processes are never stopped automatically.
What does repolink do?
Keeps a local registry of repositories and commands: `repolink commands` lists available utilities and `repolink add ~/src/aibadger` registers a project. An agent uses it to discover related repositories on the machine.
Discussion
No questions or reviews yet.
Related
CLI toolsSkills for commits, review and ZenTao plus a status line, gateway balance and session logs for Claude Code, Codex, OpenCode.
The author's personal set: shared agent rules and dozens of skills for GitHub, the browser, macOS, messaging and releases, plus a sync script
A linter for the agent harness checks a repository's AGENTS.md, CLAUDE.md, CI and hooks and scores six dimensions.
Armin's personal toolkit for the Pi Coding Agent: 18 skills, extensions, commands and themes, with some skills portable to other agents
A terminal coding agent in Go: GLM, DeepSeek and local Ollama models, 59 built-in tools and MCP
Agentic OS adds a five-step workflow and checks in git hooks and CI so that a step without evidence does not count as done
README in short
The README opens by describing the three main compressing utilities and the helpers, then gives installation via script or clone. Each command gets a short section with examples: mvn-lite, npm-lite, go-lite, slopstop, launch-browser, html-screenshot, vscode-test and RepoLink. It closes with the project status: an experimental set, not a build system or an automation framework.