Skip to main content

tAI, a terminal AI assistant

tAI is a CLI that helps you with Linux and macOS terminal commands. Just ask it a question, and it will use AI to suggest a command and explain what it does. If you like the suggestion, the script can automatically run the command for you in your terminal.

Demo

Why & What?

  • Github Copilot CLI syntax feels clunky to me
  • Faster than using Gemini, ChatGPT or similar in a browser
  • Simpler to find answers without checking man pages
  • NEW: Support for multiple AI providers (OpenAI, Google, Anthropic, Groq)
  • NEW: Interactive TUI setup using inquirer for provider and model selection
  • NEW: Enhanced terminal UI with rich for better readability and prompts
  • NEW: Now you can run commands right from this command-line interface

However, never trust the output entirely.

Installation

# install pipx (if you don't have it)
brew install pipx
pipx ensurepath

# install TAI
pipx install terminal-ai-assistant

Usage

On your first run, tai will guide you through a quick, interactive setup process to choose your AI provider, select a model from a curated list, and enter your API key. This information will be securely stored in ~/.config/tai/config.json.

Once configured, you can use tai with your queries:

$ tai kill port 3000

# Example output (formatted with rich):
╭────────────────────────────────────────────────── Command ───────────────────────────────────────────────────╮
│ kill $(lsof -t -i :3000)                                                                                     │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Execute the command: kill $(lsof -t -i :3000)? [y/n]:

Development

pip install --user pipenv
pipenv --python 3.11
pipenv install

pipenv run tai kill port 3000

Metadata

Release files for terminal-ai-assistant 4.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for terminal-ai-assistant 4.0.0
File Size Uploaded Provenance Actions
terminal_ai_assistant-4.0.0.tar.gz 5.2 kB Without provenance Details for terminal_ai_assistant-4.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for terminal-ai-assistant 4.0.0
File Interpreter ABI Platform Actions
terminal_ai_assistant-4.0.0-py3-none-any.whl Python 3 none any Details for terminal_ai_assistant-4.0.0-py3-none-any.whl

Total release size: 11.1 kB

Release files / terminal_ai_assistant-4.0.0.tar.gz

Download URL terminal_ai_assistant-4.0.0.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c712a0ca6c133178ecc8b06d082d36f6c4a40c625780068fae69d1d3c1c9aaae
BLAKE2b-256 checksum
How to use checksums
efe2f51f0d4110e868d4e6ce1621eca718d7180aa461064d8773c8c420f6d663
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Release files / terminal_ai_assistant-4.0.0-py3-none-any.whl

Download URL terminal_ai_assistant-4.0.0-py3-none-any.whl
Size 5.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fd6c1a96b5d624921e2d7cbbe6a864a08cff4dc248bf9a7f1e93fc33f8ea5b80
BLAKE2b-256 checksum
How to use checksums
daf4b09c4376eae59d333ee8ad31720e01d0137080580fc892c4a8cda7296669
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.13

Security for terminal-ai-assistant 4.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page