tgpt ๐Ÿค–

August 6, 2025 ยท View on GitHub

tgpt logo

tgpt ๐Ÿค–

GitHub go.mod Go version GitHub release (latest by date) Arch Linux package Chocolatey Version Homebrew Formula Version

tgpt is a Cross-platform Command-Line Interface (CLI) tool that allows you to use AI in your Terminal.

Demo

Currently available providers

Installation โฌ

Download for GNU/Linux ๐Ÿง or MacOS ๐ŸŽ

The default download location is /usr/local/bin, but you can change it in the command to use a different location. However, make sure the location is added to your PATH environment variable for easy accessibility.

You can download it with the following command:

curl -sSL https://raw.githubusercontent.com/aandrew-me/tgpt/main/install | bash -s /usr/local/bin

If you are using Arch Linux, you can install with pacman:

pacman -S tgpt

Install with Homebrew

brew install tgpt

FreeBSD ๐Ÿ˜ˆ

To install the port:

cd /usr/ports/www/tgpt/ && make install clean

To install the package, run one of these commands:

pkg install www/tgpt
pkg install tgpt

Install with Go

You need to add the Go install directory to your system's shell path.

go install github.com/aandrew-me/tgpt/v2@latest

Windows ๐ŸชŸ

  • Installation Script

    Open Powershell, copy and paste the command and press Enter to install.

    irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1 | iex
    

    Uninstall with

    iex "& { $(irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1) } -Uninstall"
    
  • Scoop: Package installation with Scoop can be done using the following command:

    scoop install https://raw.githubusercontent.com/aandrew-me/tgpt/main/tgpt.json
    
  • Chocolatey

    choco install tgpt
    

From Release

You can download the executable for your operating system, rename it to tgpt (or any other desired name), and then execute it by typing ./tgpt while in that directory. Alternatively, you can add it to your PATH environmental variable and then execute it by simply typing tgpt.

Updating โฌ†๏ธ

If you installed the program with the installation script, you may update it with

tgpt -u

It may require admin privileges.

Usage

Proxy

Support:

1. Environment variable

http_proxy or HTTP_PROXY with following available formats:

  • Http Proxy [ http://ip:port ]
  • Http Auth [ http://user:pass@ip:port ]
  • Socks5 Proxy [ socks5://ip:port ]
  • Socks5 Auth [ socks5://user:pass@ip:port ]

2. Configuration file

Supported file locations:

  • ./proxy.txt (in the same directory from where you are executing)
  • ~/.config/tgpt/proxy.txt

Example:

http://127.0.0.1:8080

Uninstalling

If you installed with the install script, you can execute the following command to remove the tgpt executable

sudo rm $(which tgpt)

Configuration file is usually located in ~/.config/tgpt on GNU/Linux Systems and in "Library/Application Support/tgpt" on MacOS