Skip to content

alaadotcom/CarthageAI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CarthageAI Multi-provider AI terminal assistant

Python 3.8+ License: MIT GitHub last commit

πŸš€ Features

AI-Powered Assistance

βœ” Multi-Provider Support - (OpenAI/DeepSeek)

βœ” File Analysis - Reference files with @file.txt for context-aware responses

βœ” Session Persistence - Save/load conversations with !save and !load

βœ” Rich Markdown Rendering

Terminal Productivity

⌨ Interactive CLI - Natural language queries or commands

πŸ“‚ File Integration - Supports .py, .json, .txt, and 10+ file types

⏱ Real-Time Processing - Loading spinners and timeout handling

Sysadmin Toolkit (Built-in Commands)

πŸ”Œ Test open ports | πŸ“Ά Network connectivity check

πŸ’½ Disk usage summary | πŸ” Find running processes

πŸ›‘ Audit sudo users | πŸ” SSH config analyzer

πŸ“¦ Installation

# Clone the repository
git clone https://github.com/alaadotcom/CarthageAI.git
cd CarthageAI

# Install dependencies
pip install -r requirements.txt

πŸ–₯️ Usage
Basic Commands:
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Command      β”‚ Description                             β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ !help        β”‚ Show help menu                          β”‚
β”‚ !model       β”‚ Switch AI models                        β”‚
β”‚ @file.txt    β”‚ Analyze file content                    β”‚
β”‚ !save        β”‚ Save current conversation               β”‚
β”‚ !load <id>   β”‚ Load previous session                   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Examples:

# Direct query
python carthage_ai.py "Explain Python decorators"

# File analysis
python carthage_ai.py "Fix this code" @broken_script.py

# Interactive mode:
python carthage_ai.py
> @config.json What's wrong with this configuration?

πŸ› οΈ Sysadmin Tools

  _________________________________________
 / Port Check | Disk Space | Process Find  \
| SSH Audit   | Ping Test  | Sudo Check    |
 \________________________________________/

 Example:

!portcheck example.com 80
!diskspace
!findproc nginx

API keys stored locally in config.json

About

πŸš€ Multi-provider AI terminal assistant For Developers & AI enthusiasts

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages