@nightskyai/soul-cli-ai
v0.0.6
Published

Readme

Soul CLI
Give your ideas a soul: AI code agent
Soul CLI is an enhanced AI agent built on Google's Gemini CLI foundation. It brings the power of Gemini directly into your terminal with additional features and customizations for advanced development workflows.
Quick Start
Install
npm install -g @nightskyai/soul-cli-aiRun
soulFull Documentation
For complete documentation, examples, and guides, please visit our GitHub repository:
📚 View Full Documentation on GitHub
Key Resources
- Complete README - Full documentation and setup guides
- Examples & Use Cases - Comprehensive examples for various scenarios
- Windows Installation - Step-by-step WSL setup
- Authentication Guide - OAuth, API keys, and Vertex AI setup
- Troubleshooting - Common issues and solutions
Key Features
- Free tier: 60 requests/min and 1,000 requests/day with personal Google account
- Powerful Gemini 2.5 Pro: Access to 1M token context window
- Enhanced tools: Advanced file operations, shell commands, web fetching, and custom agent system
- Extensible: MCP (Model Context Protocol) support for custom integrations
- Terminal-first: Designed for developers who live in the command line
- Task Management: Built-in todo tracking for complex workflows
- Open source: Apache 2.0 licensed
Quick Examples
Create a new project
soul
> Write me a Discord bot that answers questions using a FAQ.md fileAnalyze existing code
soul
> Give me a summary of all changes in the last 24 hoursUse with specific model
soul -m gemini-2.5-flashAuthentication Options
Option 1: OAuth login (Recommended)
soul
# Choose OAuth and follow browser authenticationOption 2: API Key
export GEMINI_API_KEY="YOUR_API_KEY"
soulLinks
- GitHub Repository: https://github.com/microize/soul-cli-ai
- Issues & Support: https://github.com/microize/soul-cli-ai/issues
- Full Documentation: https://github.com/microize/soul-cli-ai#readme
- License: Apache 2.0
Built by Nightsky Labs.ai, based on Google's Gemini CLI
