whatisgithub

What is shellgpt?

lucifer9/shellgpt — explained in plain English

Analysis updated 2026-07-15 · repo last pushed 2026-07-13

RustAudience · developerComplexity · 3/5ActiveSetup · moderate

In one sentence

A terminal-based AI assistant that answers your questions using context from your system. Its standout trick is following you across SSH connections without installing anything on remote servers.

Mindmap

mindmap
  root((repo))
    What it does
      Answers terminal questions
      Sends shell context to AI
      Keeps session history
    SSH Projection
      Follows you over SSH
      No install on remote
      Chains across hops
    Use cases
      Summarize git diffs
      Analyze remote servers
      Explain shell flags
    Tech stack
      Rust
      OpenAI API
      bash zsh fish
    Security
      Keys stay local
      Strict file permissions
      Hard size caps
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask for help with shell commands and flags without leaving the terminal.

USE CASE 2

Summarize a git diff to understand what changed before committing.

USE CASE 3

Analyze a remote server you just SSH'd into using the AI assistant that follows your connection.

USE CASE 4

Explain unfamiliar command-line flags like what -n means in grep.

What is it built with?

RustOpenAI APIbashzshfish

How does it compare?

lucifer9/shellgptbakome-hub/bakome-crypto-quant-enginecaspermeijn/nmea-test-messages
Stars0
LanguageRustRustRust
Last pushed2026-07-132024-09-16
MaintenanceActiveStale
Setup difficultymoderateeasyeasy
Complexity3/53/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an OpenAI API key and manual configuration for SSH Projection and multi-hop testing.

So what is it?

sgpt is a command-line AI assistant that lives in your terminal. You type a question or instruction in plain English, and it sends that request, along with context about your current directory, operating system, and shell, to an AI provider (like OpenAI) and returns the answer right in your terminal. It works on Linux and macOS with common shells like bash, zsh, and fish. The standout feature is something called "SSH Projection." If you SSH into a remote server, you can bring your local AI assistant along with you, without installing anything on the remote host, without exposing your API key there, and without needing the remote server to have internet access to the AI provider. Your local machine acts as a relay, so the remote server sends requests back through the tunnel and your local machine calls the provider. You can even chain this across multiple hops, like going from your laptop to server A, then from server A to server B, and the AI follows you the whole way. This is built for developers, sysadmins, or anyone who spends a lot of time in the terminal and wants quick help with commands, code analysis, or system tasks. For example, you could ask it to summarize a git diff, analyze what's happening on a remote server you've just SSH'd into, or explain what a flag like -n means in grep. The conversation history persists within a session, so you can ask follow-up questions with sgpt -c. The project is careful about security and resource limits. API keys never leave your local machine, conversation history stays local with strict file permissions, and there are hard caps on input and output sizes to prevent runaway requests. The codebase is written in Rust and includes a robust test suite, but real multi-host testing still requires manual setup.

Copy-paste prompts

Prompt 1
Help me install and configure shellgpt on macOS so I can ask AI questions from my zsh terminal, including setting up my OpenAI API key locally.
Prompt 2
Show me how to use shellgpt's SSH Projection feature so the AI assistant follows me when I SSH from my laptop into a remote server without installing anything on the remote host.
Prompt 3
Write a shellgpt command to summarize my current git diff and then ask a follow-up question about one of the changed files using session history.
Prompt 4
Explain how shellgpt keeps my API key safe when I SSH into remote servers and chains across multiple hops from server A to server B.

Frequently asked questions

What is shellgpt?

A terminal-based AI assistant that answers your questions using context from your system. Its standout trick is following you across SSH connections without installing anything on remote servers.

What language is shellgpt written in?

Mainly Rust. The stack also includes Rust, OpenAI API, bash.

Is shellgpt actively maintained?

Active — commit in last 30 days (last push 2026-07-13).

How hard is shellgpt to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is shellgpt for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.