gradient-engineer — 60‑Second Linux Analysis (Nix + LLM)

Run the classic 60‑second Linux Performance Analysis checklist on Linux or macOS. This tool enhances the original playbook with a few key improvements:

• One command: Run the entire analysis with a single line.
• Fast: Completes the analysis in about 6 seconds.
• Solves command not found: Downloads a portable Nix toolbox on the fly, so you don't need to install missing tools like iostat during a crisis.
• No dependencies: Requires no sudo, Docker, or permanent installation.
• AI Summary: Provides an optional, human-readable summary of the results.

More details in the blog post: 60-Second Linux Analysis with Nix and LLMs.

Note

This project is an early experiment.

Quick Start

Run the following command in your terminal. It works on both Linux and macOS.

curl -fsSL https://gradient.engineer/60-second-linux.sh | sh

To enable the optional AI summary, set an API key before running the script:

export ANTHROPIC_API_KEY="<your Anthropic API key>"   # OR
export OPENAI_API_KEY="<your OpenAI API key>"         # OR
export OPENROUTER_API_KEY="<your OpenRouter API key>"

Notes:

• If no key is set, the AI summary is skipped.
• Use Tab to toggle details in the TUI; q / Esc / Ctrl+C quits.

Demo

Build from Source

Requires Go 1.25 or newer.

git clone https://github.com/QuesmaOrg/gradient-engineer.git
cd gradient-engineer/app
go build -o gradient-engineer-go
./gradient-engineer-go

Advanced

• You can override the API base URL via OPENAI_BASE_URL (for OpenAI/OpenRouter) if needed.

Contributing

This is an early prototype, and we're just getting started. The repository is open-source, and we're excited to explore what's possible. Have a look at the current playbooks. We started with the classic, but we bet you have your own favorite commands—feel free to contribute them!

License

This project is licensed under the MIT License. See the LICENSE file for details.

Third-party software and licenses

This app downloads a prebuilt Linux toolbox containing third-party binaries (e.g., coreutils, util-linux, procps, sysstat, and proot). Some of these are licensed under GPL terms. See THIRD_PARTY_NOTICES.md for details and links to upstream sources. Go module dependencies each retain their own licenses; consult go.mod and the notices file for an overview.