by YassWorks
A private, provider-agnostic AI agent for your terminal.
# Add to your Claude Code skills
git clone https://github.com/YassWorks/AllyGuides for using ai agents skills like Ally.
See how Ally compares with popular alternatives.
Ally is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by YassWorks. A private, provider-agnostic AI agent for your terminal. It has 239 GitHub stars.
Ally's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/YassWorks/Ally" and add it to your Claude Code skills directory (see the Installation section above).
Ally is primarily written in Python. It is open-source under YassWorks on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Ally against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
A private, provider-agnostic AI agent for your terminal.
Ally is a command line agent that chats with you, reads and edits your files, runs commands, searches the web and answers questions from your own documents. It can run entirely on your machine with Ollama, or use OpenAI, Anthropic, Google Gemini, Groq, Cerebras or OpenRouter, and you can mix providers across its agents.
/model change.You need Git and uv. uv installs a suitable Python for you.
git clone https://github.com/YassWorks/Ally.git
cd Ally
cp .env.example .env
./setup.sh
On Windows, run the same steps in PowerShell with copy .env.example .env and .\setup.ps1.
Put the API key for your provider in .env, then set the provider and model in config.json:
{
"provider": "google",
"model": "gemini-3-flash-preview"
}
Open a new terminal and start chatting:
ally
For a fully local setup, install Ollama, pull a model and use "provider": "ollama". No API key is needed. To run Ally in Docker instead, see Getting started.
ally [--dir DIR] [--prompt PROMPT] [--id ID] [--allow-all-tools] [--create-project] [--version]
| Flag | What it does |
|---|---|
-d, --dir |
Work in this directory. It is created if it does not exist. |
-p, --prompt |
Send this message first. |
-i, --id |
Resume the session with this ID. |
--allow-all-tools |
Run tools without asking. Use with care. |
--create-project |
Start the project generation workflow. |
--version |
Print the version and exit. |
Inside a chat, type /help for every command. The most useful ones:
| Command | What it does |
|---|---|
!<command> |
Run a shell command yourself, without involving the model. |
/model, /model change <name> |
Show or switch the model. |
/id, /id <id> |
Show the session ID, or switch to another session. |
/clear |
Start a fresh conversation. |
/embed <path> <collection> |
Add files to the knowledge base. |
/start_rag, /stop_rag |
Answer from the knowledge base, or stop doing so. |
/project |
Start the project generation workflow. |
/q |
Quit. |
Ally also reads from a pipe, one message per line, which is handy for scripts:
echo "Summarize README.md in three bullet points" | ally --dir . --allow-all-tools
config.json, API keys, environment variables and where data is stored.Issues and pull requests are welcome. Read CONTRIBUTING.md first, and report security problems as described in SECURITY.md. Changes between versions are listed in the changelog.
Ally is released under the Apache 2.0 license.