Kilany Code CLI

  ◆ KILANY CODE
  Universal AI CLI - Your Terminal, Powered by AI
  ──────────────────────────────────────────────────
  by kilany team

🚀 Quick Start • 💡 Why KilanyCode? • 🎯 Use Cases • 📖 Documentation • 🤖 Providers

🌟 Why KilanyCode?

1. Multi-Provider Flexibility 🎭

The only AI CLI that lets you switch between 3 providers on the fly

• 🆓 FREE LOCAL: Ollama with 34 models - 100% offline, no API costs
• 🆓 FREE CLOUD: OpenRouter FREE tier with 100+ models - no subscription needed
• ⚡ PREMIUM: AWS Bedrock (10 models) + OpenRouter Premium (100+ models) - flagship AI
• 🔄 HOT-SWITCH: Change providers instantly with /Ollama, /OpenRouter, or /Kilany_Premium - no restart needed

Unlike ChatGPT CLI, Claude CLI, or Cursor (locked to one provider), KilanyCode gives you 244+ models across 3 providers.

2. Universal Use Cases 🌍

Not just for coding - KilanyCode adapts to your workflow:

• Developers: Code generation, debugging, refactoring, documentation
• Researchers: Data analysis, literature review, hypothesis generation
• Writers: Content creation, editing, brainstorming, SEO optimization
• Automators: Shell scripting, workflow automation, system administration
• Learners: Concept explanations, tutorials, practice problems

3. Privacy-First Design 🔒

• ✅ 100% offline with Ollama - your data never leaves your machine
• ✅ Switch to cloud models only when you need extra power
• ✅ Your code, documents, and ideas stay private by default

🚀 Quick Start

Installation (2 minutes)

Windows

winget install OpenJS.NodeJS
npm install -g kilanycode

macOS

brew install node
npm install -g kilanycode

Linux

sudo apt install nodejs npm
npm install -g kilanycode

to update kilanycode

1. Uninstall and clear cache

npm uninstall -g kilanycode npm cache clean --force

2. Install fresh

npm install -g kilanycode@latest

3. Verify version

kilanycode --version

Choose Your Provider

Option 1: FREE Local AI (Recommended for Daily Use)

kilanycode
> /Ollama

• 34 models available
• 100% free, works offline
• Perfect for daily coding, writing, learning

Option 2: FREE Cloud AI (OpenRouter FREE Tier)

kilanycode
> /OpenRouter

• 100+ free models (Llama 3.1, Gemma, Mixtral, Qwen, etc.)
• No subscription required
• Cloud-based, requires internet

Option 3: Premium Cloud AI (For Complex Tasks)

kilanycode
> /Kilany_Premium  # AWS Bedrock
> /OpenRouter      # OpenRouter Premium models

• AWS Bedrock: 10 enterprise models
• OpenRouter Premium: 100+ flagship models (GPT-4, Claude 3.5, Gemini Pro)
• Pay-per-use pricing

Start Creating

> Explain how async/await works in JavaScript

> Write a Python script to analyze CSV data and create visualizations

> Help me debug this TypeScript error: [paste error]

> Generate a blog post about the future of AI in healthcare

> Create a shell script to automate my morning dev environment setup

📖 Full Quick Start Guide

🎯 Use Cases

👨‍💻 For Developers

Code Assistance

• Generate boilerplate code, components, and modules
• Explain complex algorithms and design patterns
• Debug errors with context-aware suggestions
• Refactor legacy code for better maintainability

Architecture & Design

• Design system architecture and component hierarchies
• Review code for best practices and security issues
• Generate comprehensive API documentation
• Create unit tests and test scenarios

Example:

> Create a REST API endpoint in Express.js for user authentication with JWT tokens

> Explain the difference between TCP and UDP and when to use each

> Review this React component and suggest performance optimizations

🔬 For Researchers

Data Analysis

• Statistical analysis and hypothesis testing
• Data visualization recommendations
• Dataset exploration and preprocessing
• Results interpretation and insights

Literature & Writing

• Summarize research papers and extract key findings
• Generate research questions and hypotheses
• Draft paper sections and format citations
• Create presentation slides from papers

Example:

> Analyze this CSV dataset and identify correlations between variables

> Summarize the key findings from this climate research paper

> Suggest statistical tests to validate my hypothesis about user behavior

✍️ For Writers & Content Creators

Content Generation

• Blog posts, articles, and social media content
• Product descriptions and marketing copy
• Scripts, outlines, and story ideas
• Email templates and professional communication

Content Optimization

• Grammar, style, and tone adjustments
• SEO keyword research and optimization
• Headline generation and A/B testing ideas
• Content repurposing for different platforms

Example:

> Write a 1000-word blog post about sustainable living tips for beginners

> Rewrite this paragraph to be more engaging and conversational

> Generate 10 headline variations for my article about remote work productivity

⚙️ For System Administrators & Automators

Automation Scripts

• Shell scripts for repetitive tasks
• CI/CD pipeline configurations
• Infrastructure as Code (Terraform, Ansible)
• Cron jobs and scheduled tasks

Troubleshooting & Monitoring

• Log analysis and error diagnosis
• System performance optimization
• Security audit scripts
• Documentation and runbooks

Example:

> Create a bash script to backup my database and upload to S3 daily

> Write a Terraform configuration for a 3-tier web application on AWS

> Generate a monitoring dashboard config for Grafana

🤖 AI Providers

Ollama (FREE Local AI)

Best For: Daily work, privacy-sensitive tasks, offline development

| Feature | Details | | ------------ | ----------------------------------------- | | Cost | $0 - 100% free forever | | Location | Local (runs on your machine) | | Models | 34 open-source models | | Internet | Optional (works 100% offline) | | Privacy | Complete - data never leaves your machine | | Speed | Fast (depends on your hardware) |

Popular Models: Llama 3.2, Qwen 2.5, Gemma 2, Mistral, CodeGemma

📖 Ollama Setup Guide • Available Models

AWS Bedrock (Premium Cloud AI)

Best For: Complex tasks, enterprise use, when you need max performance

| Feature | Details | | ------------ | ------------------------------------------- | | Cost | Pay-per-use (estimate: $5-50/month) | | Location | Cloud (AWS infrastructure) | | Models | 10 premium models | | Internet | Required | | Privacy | AWS security standards | | Speed | Very fast (enterprise-grade infrastructure) |

Available Models: GPT-OSS 120B, Claude Sonnet 3.5, Llama 3.3, Mistral Large, Amazon Nova

📖 Bedrock Setup Guide • Available Models

OpenRouter (200+ Premium Models)

Best For: Access to cutting-edge models, maximum flexibility, pay-per-model

| Feature | Details | | ------------ | ----------------------------------- | | Cost | Pay-per-use (from $0.001/1K tokens) | | Location | Cloud (OpenRouter infrastructure) | | Models | 200+ models from multiple providers | | Internet | Required | | Privacy | OpenRouter security standards | | Speed | Fast (varies by model and provider) |

Available Models: Claude 3.5 Sonnet, GPT-4, Gemini Pro, Llama 3, Mistral Large, Command R+, and 190+ more from Anthropic, OpenAI, Google, Meta, Cohere, and others

Model Tiers:

• FREE Tier: Access 100+ free models (gemma-7b-it, llama-3.1-8b, mixtral-8x7b, etc.)
• Premium Tier: GPT-4, Claude 3.5, Gemini Pro, and other flagship models

📖 OpenRouter Interactive Setup

Provider Switching

Switch providers anytime without restarting:

> /Ollama              # Switch to free local AI (34 models)
> /Kilany_Premium      # Switch to AWS Bedrock (10 premium models)
> /OpenRouter          # Switch to OpenRouter (200+ models - FREE & Premium tiers)
> /KILANY_Model        # List and select specific model

Pro Tip: Use Ollama for daily work (100% free & offline), OpenRouter FREE tier for more variety, Bedrock or OpenRouter Premium for flagship models.

💰 Cost Comparison

KilanyCode vs. Alternatives

| Tool | Annual Cost | Offline | Multi-Provider | Models | | ------------------ | ------------- | ------- | -------------- | --------------- | | KilanyCode | $0-300/yr | ✅ Yes | ✅ Yes (3) | 244+ models | | ChatGPT API | $500-2000/yr | ❌ No | ❌ No | 1 model | | Claude API | $600-2500/yr | ❌ No | ❌ No | 1 model | | GitHub Copilot | $100-200/yr | ❌ No | ❌ No | 1 model | | aider CLI | $500-1500/yr | ❌ No | ❌ No | 3-5 models | | OpenRouter API | $50-500/yr | ❌ No | ✅ Yes (1) | 200+ models |

Why KilanyCode is Different:

✅ FREE local AI option (Ollama) - competitors have no free tier ✅ 244+ models across 3 providers - vs. 1-200 models from single provider ✅ 100% offline capability - essential for sensitive work ✅ No vendor lock-in - switch between Ollama, Bedrock, and OpenRouter anytime ✅ FREE + Premium options - OpenRouter FREE tier (100+ models) + Ollama (34 models) give you 134+ models at $0 cost

✨ Key Features

🔄 Hot-Swappable Providers

Switch between Ollama, OpenRouter, and AWS Bedrock instantly without restarting. Use free local AI (Ollama) for privacy, free cloud AI (OpenRouter FREE) for variety, premium cloud AI (Bedrock/OpenRouter Premium) for flagship models.

🎨 Rich Terminal UI

Beautiful, interactive terminal interface with syntax highlighting, markdown rendering, and progress indicators.

📁 File Operations

Read, write, and edit files directly from conversations. Upload code for review, generate new files, or refactor existing ones.

🧠 Memory & Context

Maintains conversation context with memory commands. Save important information for future sessions.

🔐 Security & Privacy

Enterprise-grade security with AWS Bedrock. Complete privacy with Ollama (offline). Secure credential storage with machine binding.

⚡ Performance

Fast response times with both providers. Optimized for large codebases and long conversations.

📖 Documentation

Getting Started

• Quick Start Guide - Get up and running in 5 minutes
• Installation - Detailed installation instructions
• Authentication - Security and credential setup

Providers

• Ollama Setup - FREE local AI (34 models)
• Ollama Models - Complete model catalog
• OpenRouter Setup - FREE + Premium cloud AI (200+ models)
• AWS Bedrock Setup - Enterprise cloud AI (10 models)
• Bedrock Models - Enterprise model catalog

Features

• CLI Commands - Complete command reference
• Configuration - Settings and customization
• Themes - Customize your terminal UI
• Keyboard Shortcuts - Productivity tips

Advanced

• Architecture - System design and components
• Extensions - Extend KilanyCode functionality
• IDE Integration - VS Code companion
• Troubleshooting - Common issues and solutions

🤝 Community & Support

Get Help

• 🐛 Report Issues - Bug reports and feature requests
• 💬 Discussions - Community Q&A
• 📧 Email Support - Direct support

Contributing

• 📖 Contributing Guide - How to contribute
• 🗺️ Roadmap - Upcoming features
• 📝 Changelog - Version history

📊 Comparison Matrix

KilanyCode vs. Specialized Tools

| Feature | KilanyCode | aider | cursor | llm (Simon Willison) | fabric | | ------------------- | ---------------- | ------------- | ------------ | -------------------- | --------------- | | Code Editing | ✅ | ✅ | ✅ | ❌ | ❌ | | General Chat | ✅ | ❌ | ❌ | ✅ | ✅ | | Offline | ✅ (Ollama) | ❌ | ❌ | ❌ | ❌ | | Multi-Provider | ✅ (244+ models) | ⚠️ (3 models) | ❌ (1 model) | ⚠️ (5 models) | ❌ (1 provider) | | Free Option | ✅ (134+ models) | ❌ | ❌ | ❌ | ❌ | | Terminal UI | ✅ | ✅ | ❌ | ❌ | ✅ | | IDE Integration | ✅ | ✅ | ✅ | ❌ | ❌ |

KilanyCode Advantage: Only tool with 134+ FREE models (Ollama + OpenRouter FREE tier) + 3 cloud providers + general-purpose use cases

📜 License

Apache 2.0 - Free to use, modify, and distribute.

See LICENSE for full details.

🙏 Acknowledgments

Built with:

• Ollama - Free local AI runtime (34 models)
• OpenRouter - Multi-provider AI gateway (200+ models)
• AWS Bedrock - Enterprise cloud AI (10 models)
• Ink - React for terminal interfaces

Made with ❤️ by the Kilany team

Website • GitHub • npm