Terminal Jarvis

A unified command center for AI coding tools. Manage and run claude-code, gemini-cli, qwen-code, opencode, llxprt, codex, and crush from one beautiful terminal interface.

Quick Start

# Try instantly (no installation required)
npx terminal-jarvis

# Install globally for regular use
npm install -g terminal-jarvis

# Install stable version (recommended for production)
npm install -g terminal-jarvis@stable

# Install via Cargo (Rust users)
cargo install terminal-jarvis

# Install via Homebrew (macOS/Linux)
brew tap ba-calderonmorales/terminal-jarvis
brew install terminal-jarvis

Prerequisites:

• Node.js and NPM
• macOS users: Rust toolchain required

Full installation guide: docs/INSTALLATION.md

Insights

View all 7 supported AI tools →

Try it instantly: npx terminal-jarvis

Known Issues: View current limitations and workarounds

What Terminal Jarvis Does

Terminal Jarvis is your AI coding assistant command center:

• Interactive T.JARVIS Interface: Beautiful ASCII art terminal UI with responsive design
• One-Click Tool Management: Install, update, and run AI coding tools seamlessly
• Supported Tools:
  • claude - Anthropic's Claude for code assistance
  • gemini - Google's Gemini CLI tool
  • qwen - Qwen coding assistant
  • opencode - Terminal-based AI coding agent (Testing)
  • llxprt - Multi-provider AI coding assistant (Testing)
  • codex - OpenAI Codex CLI for local AI coding (Testing)
  • crush - Charm's multi-model AI assistant with LSP (New)

BETA = Looking for testers! These tools are new additions.

How to Use Terminal Jarvis

Interactive Mode (Recommended)

# Launch the full T.JARVIS experience
terminal-jarvis

Get the complete interface with:

• Beautiful ASCII art welcome screen
• Real-time tool status dashboard
• Quick tool selection and launching
• Built-in management options
• Smart guidance and tips

Direct Commands

# Install and manage tools
terminal-jarvis install claude
terminal-jarvis update               # Update all tools
terminal-jarvis list                # Show tool status
terminal-jarvis info claude         # Tool details

# Run tools directly
terminal-jarvis run claude --prompt "Refactor this function"
terminal-jarvis run gemini --file src/main.rs
terminal-jarvis run qwen --analyze
terminal-jarvis run opencode --generate
terminal-jarvis run llxprt --help

Template Management

# Template workflow (requires gh CLI)
terminal-jarvis templates init       # Setup templates repo
terminal-jarvis templates create my-template
terminal-jarvis templates list
terminal-jarvis templates apply my-template

Supported AI Tools

Tool	Description	Status	Installation Command
claude	Anthropic's Claude for code assistance	Stable	npm install -g @anthropic-ai/claude-code
gemini	Google's Gemini CLI tool	Stable	npm install -g @google/gemini-cli
qwen	Qwen coding assistant	Stable	npm install -g @qwen-code/qwen-code@latest
opencode	Terminal-based AI coding agent	Testing	npm install -g opencode-ai@latest
llxprt	Multi-provider AI coding assistant	Testing	npm install -g @vybestack/llxprt-code-core
codex	OpenAI Codex CLI for local AI coding	Testing	npm install -g @openai/codex
crush	Charm's multi-model AI assistant with LSP	New	npm install -g @charmland/crush

*See limitations for known issues and workarounds

Configuration (Optional)

Terminal Jarvis works out-of-the-box, but you can customize behavior with configuration files:

Locations (in priority order):

• ./terminal-jarvis.toml (project-specific)
• ~/.config/terminal-jarvis/config.toml (user-wide)

Example configuration:

[tools]
claude = { enabled = true, auto_update = true }
gemini = { enabled = true, auto_update = false }
qwen = { enabled = true, auto_update = true }
opencode = { enabled = false, auto_update = false }
llxprt = { enabled = true, auto_update = true }
codex = { enabled = true, auto_update = true }
crush = { enabled = true, auto_update = true }

[templates]
repository = "your-username/jarvis-templates"
auto_sync = true

Documentation

• Installation Guide - Platform-specific setup instructions
• Known Limitations - Current issues and workarounds
• Architecture Guide - Technical details and development info
• Testing Guide - How to test and contribute

Contributing

We welcome contributions! Please join our Discord community first to discuss your ideas.

Quick Start:

1. Join the Terminal Jarvis Discord
2. Discuss your contribution in #features or #bugfix channels
3. Fork the repository
4. Create a feature branch (git checkout -b feature/amazing-feature)
5. Follow our contribution guidelines
6. Ensure tests pass (cargo test)
7. Use our PR template for submitting changes

Full Guide: docs/CONTRIBUTIONS.md - Complete contributor guide with coding standards, testing requirements, and development workflow.

Technical Details: docs/ARCHITECTURE.md - Architecture overview and development setup.

Support the Project

If Terminal Jarvis has been helpful for your AI coding workflow, consider supporting development:

Your support helps maintain and improve Terminal Jarvis for the entire community! 🙏

License

This project is licensed under the MIT License - see the LICENSE file for details.

Roadmap

• Interactive T.JARVIS Interface with ASCII art
• Smart tool detection and status reporting
• One-click installation with NPM validation
• Responsive terminal design
• Enhanced authentication flows (addressing current login issues)
• Improved wrapper layer stability
• Plugin system for custom tools
• Shell completion scripts
• Web dashboard for tool management