Skip to content
MahdiBNDPublic

About

Simple Interactive ai inside terminal, in Python.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

34 Commits

Folders and files

Repository files navigation

Shell AI

A lightweight AI-powered terminal assistant built with AgentKit: currently private

Shell AI provides an interactive terminal interface with streaming responses, Markdown rendering, and persistent conversation context during each session.

Features

  • Interactive terminal UI powered by Prompt Toolkit.
  • Markdown-rendered responses using Rich.
  • Real-time streaming through AgentKit.
  • Tool calling support.
  • Session-based conversation context.
  • Global and project-level environment configuration.
  • Run via cloudflare tunnel.

Installation

uv tool install .

Configuration

Create a global environment file:

mkdir -p ~/.config/shell-ai
touch ~/.config/shell-ai/.env

Add env keys:

GOOGLE_API_KEY=your_google_api_key
RELAY_URL=your_relay_url

Usage

Start the assistant:

shai

Type your messages and interact with the assistant. Enter exit or quit to leave.

Development

Clone the repository and install dependencies:

uv sync
uv run shai

After making changes, reinstall the CLI:

uv tool install .

Requirements

  • Python 3.14+
  • uv
  • AgentKit

License

MIT

About

Simple Interactive ai inside terminal, in Python.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages