aulthium-cli
Health Warn
- License — License: GPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Run Aulthium AI Agent instantly in Termux, Linux, or any terminal with a single command.
Aulthium
The open-source AI agent that runs anywhere you have a terminal — including your phone.
Code • Search • Automate • Extend — on Linux, macOS, or Android (Termux)
https://github.com/user-attachments/assets/4135e436-9359-432f-b2bb-94c279adcdfb
The terminal is your workspace. Aulthium is your agent.
🚀 Quick Start
Run Aulthium with a single command:
bash <(curl -fsSL https://raw.githubusercontent.com/d3stiny-io/aulthium-cli/main/aulthium-cli.sh)
Then configure your AI provider and start working. That's it.
[!IMPORTANT]
This one-liner downloads and runs a shell script directly from this repo. Always readaulthium.shyourself before piping it intobashif you want to know exactly what it does on your machine.
[!TIP]
On Android, install Termux first, then run the same command above — no other setup required.
⚡ What is Aulthium?
Aulthium is a free and open-source AI agent designed to work directly from your terminal — no editor lock-in, no subscription, no desktop required.
It can understand your project, work with files, execute commands, search the web, connect to MCP servers, and now extend itself through plugins.
Most AI coding agents assume you're at a desk. Aulthium doesn't. Install it on a Linux box, a macOS laptop, a remote server, or straight onto your Android phone via Termux — same agent, same plugins, same control, wherever your terminal is.
AI proposes. You stay in control.
🚀 Why Aulthium?
Most AI coding tools are built around a specific editor, platform, or subscription.
Aulthium takes a different approach:
┌──────────────────────┐
│ AULTHIUM │
│ AI AGENT │
└──────────┬───────────┘
│
┌─────────────────┼─────────────────┐
│ │ │
▼ ▼ ▼
┌────────────┐ ┌────────────┐ ┌────────────┐
│ YOUR CODE │ │ TERMINAL │ │ THE WEB │
└────┬───────┘ └────┬───────┘ └─────┬──────┘
│ │ │
└────────────────┼──────────────────┘
│
▼
┌──────────────────────┐
│ YOUR PLUGINS │
└──────────────────────┘
Bring your own provider.
Bring your own tools.
Bring your own plugins.
Make the agent yours.
| Typical AI coding tools | Aulthium | |
|---|---|---|
| Runs on | Desktop editor / IDE | Linux, macOS, server, Android (Termux) |
| Provider | Locked to one vendor | Bring your own key — OpenRouter, Google, Mistral, HF, NVIDIA, custom |
| Extending it | Wait for a feature request | Build a plugin yourself |
| Execution | Varies | Every shell command needs your explicit [y/N] |
| Cost | Subscription | Free, open-source (GPL-3.0) |
✨ Features
🤖 AI AgentWork with your projects using natural language.
|
📝 File OperationsAulthium can work directly with your project files.
|
⚡ Shell CommandsRun terminal commands through the agent with user approval. You remain in control of what actually executes. |
🔍 Web SearchGive the agent access to current information when its existing knowledge isn't enough. Useful for:
|
🧩 Plugin SystemDon't wait for a feature to be added to the core. Build it yourself. Create plugins that add new tools, workflows, integrations, and interfaces. |
🔗 MCPConnect Aulthium to compatible Model Context Protocol servers over HTTPS. Extend the agent beyond its built-in capabilities. |
🌐 WebChatUse Aulthium through a local browser-based interface. Perfect when you want the agent's capabilities without staying inside the terminal UI. |
📱 TermuxRun your AI agent directly on Android. No desktop required. Your phone can be your development environment. |
📊 Star History
Track Aulthium's GitHub stars over time. This chart is generated dynamically, so it updates automatically as the repository gains stars.
🧩 Plugins
Aulthium is extensible.
The new plugin system lets developers create functionality outside of the Aulthium core.
That means the community can build features without waiting for every idea to become a core feature.
Aulthium
│
├── Core Agent
│
├── Web Search
│
├── HTTPS MCP
│
└── Plugins
├── Built-in Plugins
├── Community Plugins
└── Your Plugins
📦 Plugin structure
~/.aulthium/plugins/<plugin-name>/
├── plugin.json
└── ...
🛠️ Example manifest
{
"name": "hello",
"description": "A simple Aulthium plugin",
"version": "1.0.0",
"entry": "python3 hello.py",
"runtime": "python3"
}
🎮 Plugin commands
a> plugin list
a> plugin info <name>
a> plugin install /path/to/plugin
a> plugin run <name>
💡 What can plugins do?
Your imagination is the limit.
Plugins can be used for:
- 🔧 Developer tools
- 🌐 Web interfaces
- 🤖 Custom AI tools
- 📡 API integrations
- ⚙️ Automation
- 📁 File utilities
- 🎮 Experiments
- 🧪 New agent capabilities
Want something that Aulthium doesn't have?
Build a plugin.
📚 Read the Plugin Development Guide
[!WARNING]
Plugins are trusted programs and may run with your normal user permissions. Only install plugins you trust.
🌐 WebChat
Aulthium ships with a built-in WebChat plugin.
Instead of interacting with the agent entirely through the terminal, you can open a local browser interface.
a> plugin run webchat
WebChat is designed to be:
- 📱 Mobile-friendly
- 🌐 Browser-based
- 🔌 Connected to your configured provider
- 🧠 Connected to your configured model
- 🔒 Local
Terminal when you want it.
WebChat when you don't.
[!NOTE]
WebChat runs entirely on your machine — nothing is sent anywhere except to your configured AI provider.
🔌 Bring Your Own AI
Aulthium doesn't force you into one AI provider.
Use your own API key and choose the provider and model that works for you.
Depending on the current version, providers can include:
| Provider | Type |
|---|---|
| OpenRouter | Multi-model |
| AI models | |
| Mistral | AI models |
| Hugging Face | AI models |
| NVIDIA NIM | AI models |
| OpenAI-compatible APIs | Custom-compatible |
| Custom endpoints | Your own backend |
Your key. Your provider. Your model.
🛡️ Human in the Loop
Aulthium is designed so the AI doesn't simply execute everything without you.
For example:
┌─ ❯ SHELL RUN ─────────────────────────────────┐
│ cwd: /your/project │
│ npm install example-package │
└─────────────────────────────────────────────┘
⚠ This is NOT sandboxed to the workspace folder.
? Run this command? [y/N]
The agent suggests an action.
You decide whether it happens.
Always review commands, file changes, MCP connections, and plugins before approving them.
🔍 Web-Aware Development
Software changes quickly.
A package that worked yesterday can change tomorrow.
Aulthium can search the web when fresh information is needed.
You
│
▼
Aulthium
│
├── Understand request
│
├── Search when needed
│
├── Read relevant information
│
└── Continue working
This makes it useful for:
- 📚 Documentation
- 🔧 Debugging
- 📦 Package research
- 🌐 API development
- 🆕 Recent changes
📱 Built for the Terminal
Aulthium is designed for environments where a terminal is available.
Supported environments
- 🐧 Linux
- 🍎 macOS
- 📱 Android through Termux
That means you can have an AI coding agent on a phone without needing a traditional desktop IDE.
🧠 Examples
Ask Aulthium:
Create a Python API for this project.
Find why this program is crashing.
Read the project structure and explain how it works.
Search the web for the latest documentation for this API.
Create a plugin that adds a custom tool.
Fix the bugs in this project and explain what you changed.
Aulthium isn't just a chatbot.
It's an agent that can work with your environment.
🧪 Project Status
Aulthium is actively evolving.
Some features are experimental and the project may contain bugs.
The plugin ecosystem, MCP functionality, WebChat, and agent capabilities are continuously being improved.
If something breaks:
Tell us. Fix it. Build on it.
💬 Community
Join the Aulthium community on Discord to ask questions, share plugins, and connect with other users.
Subscribe to the official YouTube channel for demos, updates, and tutorials.
🤝 Contributing
Aulthium is open source, and contributions are welcome.
You can contribute by:
- 🐛 Reporting bugs
- 💡 Suggesting features
- 🔧 Fixing issues
- 📚 Improving documentation
- 🧩 Creating plugins
- 🔀 Opening pull requests
Not every feature needs to live inside the core.
Sometimes the best contribution is simply:
Build a plugin.
📋 Requirements
Core
- Bash
curl- Internet connection
- API key for your selected provider
Plugins
Individual plugins may require additional runtimes or packages.
For example:
- Python
- Node.js
- Other runtimes
📄 License
Aulthium is licensed under the GPL-3.0 License.
See LICENSE for the full license.
⭐ Built with vision. Powered by AI. Improved by humans.
If Aulthium is useful to you, consider giving the repository a star.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found