██████╗ ██╗   ██╗███████╗████████╗
  ██╔════╝ ╚██╗ ██╔╝██╔════╝╚══██╔══╝
  ██║  ███╗ ╚████╔╝ ███████╗   ██║
  ██║   ██║  ╚██╔╝  ╚════██║   ██║
  ╚██████╔╝   ██║   ███████║   ██║
   ╚═════╝    ╚═╝   ╚══════╝   ╚═╝   

Get your sh*t together.

7 AI-powered commands for your terminal. Natural language git, code review with auto-fix, roasting, error explanations, standup generation, and more.

npm install -g gyst
TypeScriptClaude / GPT / GeminiMulti-ProviderStreaming OutputLocal LLM Support
~/my-project
$ gyst git "undo my last commit but keep the changes"
🔧 Git Command
git reset --soft HEAD~1
Undoes the last commit while preserving all changes in the staging area
Run this command? (Y/n): Y
✓ Done
$ gyst review src/api/auth.ts --fix
🔴 SQL Injection Vulnerability
src/api/auth.ts:42-45
User input directly concatenated into SQL query
- `SELECT * FROM users WHERE id = '${userId}'`
+ `SELECT * FROM users WHERE id = $1`, [userId]
1 critical · 2 warnings · 3 auto-fixable
$ gyst roast index.js --severity brutal
💀 Roast mode: BRUTAL
Line 1: `var express = require('express')` — Using var in 2026? This code is a time capsule. Someone call the archaeology department.
📊 Overall: 3/10
🎤 This code doesn't just have bugs — it IS the bug.

Built for developers who ship fast

Every feature is designed to save you time and make your terminal experience better.

🚀

2-Minute Setup

Interactive setup wizard gets you running instantly. Validates your API key, sets defaults, and configures preferences — all guided.

🧠

Multi-Provider AI

Works with Claude, GPT-4, Gemini, Llama (via Groq), DeepSeek, and local Ollama models. Switch providers with a single flag.

Streaming Output

Responses stream token-by-token for instant feedback. No staring at a blank screen waiting for the full response.

🔧

Auto-Fix Code

The review command doesn't just find bugs — it provides exact code replacements that can be auto-applied with --fix.

🎯

Context-Aware

Detects your project type, framework, package manager, and git state to give you relevant, specific answers.

🏠

Local LLM Support

Run entirely offline with Ollama. Use --local or configure any model with local:model-name prefix.

🎨

Beautiful Terminal UI

Colorful, well-formatted output with boxes, spinners, severity icons, and diff-style code suggestions.

11 commands. Infinite time saved.

Every command is designed to do one thing well, with beautiful output and smart defaults.

gyst setup

Interactive setup wizard — up and running in 2 minutes

  • -Choose from 6 AI providers with guided setup
  • -Validates your API key before saving
  • -Configure default model and preferences
$ gyst setup
gyst git

Translate natural language to git commands

  • -Understands your repo context (branch, status, remotes)
  • -Warns about destructive commands
  • -Shows alternatives and confirms before executing
$ gyst git "squash the last 3 commits"
gyst commit

AI-generated commit messages from staged changes

  • -Conventional Commits format (feat, fix, refactor, etc.)
  • -Accept, edit in $EDITOR, or cancel
  • -Analyzes diffs for accurate descriptions
$ gyst commit --all
gyst pr

Generate PR descriptions from branch changes

  • -Auto-detects base branch (main/master)
  • -Summary, Changes, and Testing checklist
  • -Copy to clipboard or create via GitHub CLI
$ gyst pr --copy
gyst changelog

Generate changelogs from git history

  • -Keep a Changelog format (Added/Changed/Fixed/Removed)
  • -Auto-detects last git tag as range start
  • -Prepends to existing CHANGELOG.md
$ gyst changelog --since v0.1.0
gyst review

AI code review with actionable fixes

  • -Finds real bugs, security issues, and anti-patterns
  • -Provides exact code replacements for auto-fix
  • -Severity levels: critical, warning, suggestion, nitpick
$ gyst review src/ --fix
gyst roast

Get a brutally honest code roast

  • -Three severity levels: gentle, medium, brutal
  • -Technically accurate humor — learns from real issues
  • -Includes a score out of 10 and final verdict
$ gyst roast app.js --severity brutal
gyst wtf

Explain any error message

  • -Pipe errors directly from your build tools
  • -Gets project-specific fix suggestions
  • -Copy-paste ready commands to resolve issues
$ npm run build 2>&1 | gyst wtf
gyst standup

Generate standup updates from git history

  • -Analyzes your commits and groups related work
  • -Text, Slack, and JSON output formats
  • -Configurable time range with --since or --days
$ gyst standup --days 3 --format slack
gyst readme

Generate a README from your codebase

  • -Analyzes project structure, deps, and scripts
  • -Styles: minimal, detailed, startup pitch
  • -Won't overwrite existing README (saves as .generated.md)
$ gyst readme --style startup
gyst explain

Explain what code does in plain English

  • -Works with files and directories
  • -Explains purpose, patterns, and trade-offs
  • -Streaming output for large codebases
$ gyst explain src/core/

Up and running in 30 seconds

1

Install globally

$ npm install -g gyst-ai
or: pnpm add -g gyst-aior: yarn global add gyst-ai
2

Run the setup wizard

$ gyst setup

The interactive wizard walks you through provider selection, API key configuration, and preferences. Or set your key manually:

Anthropic (Claude)export ANTHROPIC_API_KEY=...
OpenAI (GPT)export OPENAI_API_KEY=...
Google (Gemini)export GOOGLE_GENERATIVE_AI_API_KEY=...
Groq (Llama)export GROQ_API_KEY=...
Ollama (Local)gyst git --local 'show recent commits'
3

Start using it

$ gyst git "show me what changed this week"
$ gyst commit
$ gyst review src/ --fix
$ gyst pr --copy
$ gyst wtf "ECONNREFUSED 127.0.0.1:5432"