⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

code-review

axium-labs@axium-labs⭐ 392 stars· last commit 10d ago· 0 open issues

Review diffs, commits, pull requests or whole-project code for actionable correctness, security, performance and maintainability issues, following the requested scope.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 392 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

AX

A fast, lightweight AI agent for the terminal, built in Rust.

One source workspace builds for Windows, Linux and macOS. See platform support for native build targets, shell settings, installation and capability limits; new platform archives require a release containing those assets before they can be downloaded.

License: Apache-2.0 Rust 1.92+

English | 简体中文

AX is a small, native terminal agent. It starts fast, streams responses, and keeps sessions, memory, credentials and model config on your machine — no service to sign up for, no remote telemetry.

AX is the agent; AX Crew is the control plane built alongside it — it orchestrates and controls AX across multiple machines and keeps their work running when a machine goes offline. See ACP and Crew integration.

  • Rust native — one binary for the terminal agent; no Node or Docker needed for core use. Optional Browser Use needs Node and Playwright.
  • Independent UI permissions — app/site access and action approval are separate from the file/terminal sandbox. Computer Use defaults on and preserves explicit disable settings; Windows UIA, Linux AT-SPI and macOS Accessibility adapters have platform prerequisites and limits. See Computer Use and host access.
  • Fast startup — providers, skills, MCP servers and memory load on demand.
  • Local system resources — /system shows measured CPU/memory usage and supported NVIDIA GPU usage/VRAM; collection runs only when requested.
  • Standard skills and focused tools — Agent Skills SKILL.md packages with lazy instructions and optional resources, read-only web search/fetch that batches concurrent queries and page fetches and deduplicates their results, LSP through configurable MCP servers, and native image input on supported vision models.
  • Small binary — a compact workspace of focused crates, not a framework.
  • Simple workflow — type, get an answer, switch models, move on.
  • Local-first — sessions, memory and settings live in .ax beside the AX executable.

No benchmarks are published yet; "fast" here means the startup path does as little as possible by design.

By default, AX stores persistent data under <install-dir>/.ax, with separate project stores in projects/<project-key>/. Opening another working directory does not move data there; deleting a workspace does not delete its history. On first launch, legacy ~/.ax and known project .ax stores are copied without deleting the originals. AX_HOME and --data-dir remain explicit overrides.

Portable backups: ax export backup.axpack saves sessions and memory; use --memory or --sessions to select one type. Run ax import backup.axpack --dry-run to inspect conflicts, then ax import backup.axpack to merge. Credentials and caches are excluded. See backup details.

Quick Start

Installing and running AX

Mac or Linux:

curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh

Windows:

powershell -ExecutionPolicy Bypass -c "iex ((iwr 'https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.ps1' -UseBasicParsing).Content)"

Then simply run:

ax

Your first session:

/login      # sign in with a provider (Codex OAuth or an API key)
/model      # pick a model
hello       # just start typing

That's it. Your session is saved automatically, and the model you pick is remembered for next time.

Installation

The installer fetches the latest release from GitHub, verifies the archive against the release's SHA256SUMS, and installs a single ax / ax.exe binary:

  • macOS / Linux — installs to ~/.local/bin by default and prints a PATH hint if that directory is not already on your PATH.
  • Windows — installs to %LOCALAPPDATA%\Programs\AX\bin by default and adds it to your user PATH (only if it is not there already).

Both installers accept two environment variables:

VariablePurpose
AX_VERSIONInstall a specific release tag instead of the latest (default: latest)
AX_INSTALL_DIROverride the install directory

To update the executable you are currently running to the latest GitHub Release, run ax --update. AX checks the release version, verifies the download against SHA256SUMS, and replaces that executable; it also refreshes the bundled payload from the same archive, installing any missing skill package into <install-dir>/.ax/skills and writing <install-dir>/.ax/mcp.toml only when no config exists yet (existing skills and configs are left alone). The bundled payload is refreshed on every ax --update, even when the binary is already up to date, so newly added skill packages are picked up without a version bump. On Windows, the verified update is scheduled for replacement after the command exits; restart AX before using the new version. The command does not otherwise change your <install-dir>/.ax user data or any project's .ax directory. If you installed a separate copy using AX_INSTALL_DIR, run that copy's ax --update to update it. A push to main alone is not a release; the release workflow runs for v* tags.

curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh
AX_INSTALL_DIR="$HOME/bin" curl -fsSL https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.sh | sh
powershell -ExecutionPolicy Bypass -c "iex ((iwr 'https://raw.githubusercontent.com/Axium-Labs/AX/main/scripts/install.ps1' -UseBasicParsing).Content)"

Uninstall

Removing AX is just deleting the binary (and, on Windows, the PATH entry the installer added). AX keeps its data separately in <install-dir>/.ax, which you can delete too if you want a clean slate.

macOS / Linux

rm -f ~/.local/bin/ax        # or wherever AX_INSTALL_DIR pointed
rm -rf ~/.local/bin/.ax                 # config, sessions, memory, model catalog (optional)

Windows

Remove-Item -Force "$env:LOCALAPPDATA\Programs\AX\bin\ax.exe"
# remove the installer's PATH entry (optional but tidy)
$p = [Environment]::GetEnvironmentVariable('Path', 'User')
[Environment]::SetEnvironmentVariable('Path', ($p -split ';' | Where-Object { $_ -notlike '*Programs\AX\bin*' }) -join ';', 'User')
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Programs\AX"   # deletes stored sessions and memory too (optional)

Development

Build from source

Requires Rust 1.92+.

git clone https://github.com/Axium-Labs/AX.git
cd AX
cargo build --release
# binary at target/release/ax.exe (Windows) or target/release/ax (Unix)

Providers & Models

AX discovers providers from what is already on your machine — credentials in <install-dir>/.ax/auth.json and standard environment variables like DEEPSEEK_API_KEY. No network call happens during startup.

ProviderCredentialHow to use
OpenAI CodexOAuth login/login → Codex OAuth
WorkBuddy InternationalBrowser OAuth + token pollingax auth login workbuddy --region intl, or /login → WorkBuddy International
WorkBuddy ChinaBrowser OAuth + token pollingax auth login workbuddy --region cn, or /login → WorkBuddy China
DeepSeekAPI key/login → API key, or DEEPSEEK_API_KEY
OpenAIAPI key/login → API key, or OPENAI_API_KEY
OpenAI-compatible vendors (Groq, Mistral, OpenRouter, etc.)Provider API key/login → provider, or its API-key environment variable

Models are discovered dynamically into <install-dir>/.ax/models/ (a bundled catalog plus a per-provider refresh cache). Switch anytime with /model; the last select

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • skills/code-review/SKILL.md1.9 KB1beb06e50748upstream ↗
    ---
    name: code-review
    description: Review diffs, commits, pull requests or whole-project code for actionable correctness, security, performance and maintainability issues, following the requested scope.
    compatibility: Requires git when reviewing repository changes.
    allowed-tools: filesystem search shell
    ---
    # Code review
    
    Use the scope requested by the user. For a diff, commit or pull request review,
    read the complete relevant diff and enough surrounding code to understand each
    changed path. For a whole-project or existing-code audit, inspect the requested
    modules and their interactions, including pre-existing issues. Read repository
    instructions and check call sites/tests before reporting a defect. Continue
    through the requested scope after finding an issue.
    
    For a branch review, resolve the comparison ref and use the merge base so the
    review covers the changes that would merge. For a commit or uncommitted work,
    inspect that exact target. If the target is ambiguous, infer it from the current
    task and repository state before asking.
    
    For change reviews, default to discrete, actionable regressions introduced by
    the change. If the user requests a broader audit or pre-existing issues, include
    those findings and distinguish them from newly introduced regressions. For
    whole-project audits, do not limit findings to a recent diff. Explain the failure
    scenario or concrete impact and cite the smallest useful file and line. Avoid
    speculation and cosmetic preferences; when the user requests style/convention
    review, assess against the requested standards.
    
    Present findings first, ordered by severity: P0 for a critical release blocker,
    P1 for urgent defects, P2 for ordinary defects, and P3 for lower-impact defects.
    If there are no findings, say so. Briefly mention the review scope and any
    material verification gap. Treat a review request as read-only unless the user
    also asks for fixes.
    
    Adapted for AX from Codex's `review-agent` sample skill.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/axium-labs-ax-skills-code-review.md

// REPO STATS

392 stars
0 open issues
Last commit: 10d ago