█████╗ ███╗ ██╗██╗███╗ ███╗ █████╗ ██╗ ██╗████████╗██╗ ██╗ █████╗ ██╗
██╔══██╗████╗ ██║██║████╗ ████║██╔══██╗██║ ██║╚══██╔══╝╚██╗ ██╔╝ ██╔══██╗██║
███████║██╔██╗ ██║██║██╔████╔██║███████║██║ ██║ ██║ ╚████╔╝ ███████║██║
██╔══██║██║╚██╗██║██║██║╚██╔╝██║██╔══██║██║ ██║ ██║ ╚██╔╝ ██╔══██║██║
██║ ██║██║ ╚████║██║██║ ╚═╝ ██║██║ ██║███████╗██║ ██║ ██║ ██╗██║ ██║██║
╚═╝ ╚═╝╚═╝ ╚═══╝╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝
```// Modified by Animality AI, 2025-06-29
# animality.ai CLI
This CLI is an Apache-2.0 derivative of Google's Gemini CLI. LICENSE & NOTICE preserved.
This repository contains the animality.ai CLI, a command-line AI workflow tool that connects to your
tools, understands your code and accelerates your workflows.
With the animality.ai CLI you can:
- Query and edit large codebases in and beyond the AI model's 1M token context window.
- Generate new apps from PDFs or sketches, using multimodal AI capabilities.
- Automate operational tasks, like querying pull requests or handling complex rebases.
- Use tools and MCP servers to connect new capabilities, including [media generation with Imagen,
Veo or Lyria](https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio/tree/main/experiments/mcp-genmedia)
- Ground your queries with the [Google Search](https://ai.google.dev/gemini-api/docs/grounding)
tool, built in to the AI model.
</div>
---
```bash
npx @animality/cli
The Gemini CLI is your intelligent development assistant that bridges the gap between natural language and code execution. Think of it as having a senior developer who understands your entire codebase, can read your mind, and executes complex tasks with surgical precision.
npm install -g @animality/cli
animality-cli- Pick a color theme
- Authenticate: When prompted, sign in with your personal Google account. This will grant you up to 60 model requests per minute and 1,000 model requests per day using the AI model.
You are now ready to use the animality.ai CLI!
Need higher limits or specific models? Use an API key:
- Generate key: Visit Google AI Studio
- Set environment variable:
export GEMINI_API_KEY="your_key_here"
- Enterprise setup: See authentication guide for Google Workspace accounts
Once the CLI is running, you can start interacting with AI from your shell.
mkdir my-awesome-project && cd my-awesome-project
gemini> Write me a Discord bot that answers questions using a FAQ.md file I will provide
cd new-project/
animality-cli
> Write me a Discord bot that answers questions using a FAQ.md file I will providegit clone https://github.com/animality-ai/cli
cd cli
animality-cli
> Give me a summary of all of the changes that went in yesterday
</details>
<details>
<summary><b>🛠️ Feature Development</b></summary>
```text
> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan
> Add TypeScript support to this project with proper configuration🤖 Automation & Workflows
> Make me a slide deck showing the git history from the last 7 days, grouped by feature
> Create a full-screen web app for displaying our most active GitHub issues
> Set up a CI/CD pipeline that deploys to staging on every PR
Start by cding into an existing or newly-cloned repository and running animality-cli.
> Convert all images in this directory to PNG and rename them using EXIF dates
> Organize my PDF invoices by month of expenditure
> Clean up this messy JavaScript project and add proper linting
| Resource | Description |
|---|---|
| 🚀 CLI Commands | Master all available commands |
| 🔧 Troubleshooting | Solve common issues quickly |
| 📚 Full Documentation | Comprehensive guides |
| 🤝 Contributing | Help improve Gemini CLI |
| 💡 Popular Tasks | Get inspired with real examples |
Perfect for new team members or exploring unfamiliar codebases
cd any-project && gemini|
🔍 Architecture Deep Dive |
🔒 Security & Quality Review |
From idea to implementation in minutes
|
⚡ Rapid Prototyping |
🔄 Migration & Modernization |
Let AI handle the repetitive tasks
|
📊 Reporting & Analytics |
🔧 Infrastructure & CI/CD |
Organize and transform your data intelligently
|
🖼️ Media Processing |
📄 Document Management |
💡 The key to success: Be specific about what you want, provide context, and don't be afraid to iterate!
| Resource | Description |
|---|---|
| 🎓 Tutorials | Step-by-step guides for common tasks |
| ⚙️ Configuration | Customize Gemini CLI to your workflow |
| 🎨 Themes | Beautiful color schemes for your terminal |
| 🔧 Advanced Features | Power user commands and options |
| Integration | Description |
|---|---|
| 🔌 MCP Servers | Connect external tools and services |
| 🌐 Web Search | Real-time information with Google Search |
| 📁 File System | Advanced file and directory operations |
| 💾 Memory | Persistent context across sessions |
For details on the terms of service and privacy notice applicable to your use of Gemini CLI, see the Terms of Service and Privacy Notice.
Made with ❤️ by the Google Gemini team Modified with ☕️ by the Animality.ai Team
Transforming the way developers build, one command at a time.