Skip to content

jacanwallach4/ghostshell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

ghostshell

GhostShell

An AI-powered terminal assistant that makes your command line smarter.

📌 Overview

GhostShell turns your boring terminal into an intelligent companion. It suggests commands, explains errors, and automates repetitive tasks — all without leaving your shell.

✨ Features

🧠 AI-powered command suggestions

❓ Instant error explanations (why did this fail?)

⏱️ Command history auto-optimization

🔄 Workflow automation with natural language ("create a backup every hour")

🎨 Minimal but slick terminal UI

🛠 Built With

Python 3.11

OpenAI API (natural language processing)

Rich (terminal formatting)

SQLite (local cache)

📦 Installation git clone https://github.com/yourusername/ghostshell.git cd ghostshell pip install -r requirements.txt

▶️ Usage

Start the assistant:

ghostshell

Examples:

how to find all .log files in current folder? Suggested: find . -type f -name "*.log"

why did "git push" fail? Explanation: You don’t have permission for this branch. Try: git push origin HEAD:main

📂 Example Config theme: "dark" ai_provider: "openai" autosuggest: true error_explain: true

🔮 Roadmap

Plugin system for custom commands

VS Code integration

Offline LLM support

Shared command packs

🤝 Contributing

Contributions are welcome! Fork the repo, open an issue, or submit a pull request.

About

No description or website provided.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published