Documentation

Everything you need to know about using Kite effectively.

Getting Started

Installation

  1. 1

    Download Kite.dmg

    Get the latest version from our downloads page

  2. 2

    Drag to Applications

    Install Kite by dragging it to your Applications folder

  3. 3

    Launch & Start Using

    Open Kite and start using it immediately with the free Gemini-powered version

Basic Usage

Just type your command in plain English:

Cleanup
$ kite "clean up downloads folder"
→ Organizing files by type... → Moving old files to archive... → Freed up 2.1 GB of space

Basic Usage

Using Kite

Just type your command in plain English:

Cleanup
$ kite "clean up downloads folder"
→ Organizing files by type... → Moving old files to archive... → Freed up 2.1 GB of space

Macros

Creating Macros

Create shortcuts for frequently used commands:

Manual Creation
$ create alias "quick-commit" for "git add . && git commit -m 'Quick update' && git push"
→ Created macro 'quick-commit' → Use it by typing: quick-commit
Auto-Suggestion
$ kite "set up development environment with vim, git status, and dev server"
→ This command is used frequently. Would you like to create a macro? → Suggested name: 'dev-setup' → Type 'yes' to confirm

Managing Macros

List Macros
$ macros
→ User-defined macros: • quick-commit (used 12 times) • dev-setup (used 5 times) • sys-info (used 3 times) → Suggested macros: • backup-photos • clean-downloads
Delete Macro
$ delete alias "quick-commit"
→ Deleted macro 'quick-commit'

Macro Rules

  • • Macro names can only contain letters, numbers, hyphens, and underscores
  • • Reserved words cannot be used as macro names (help, fly, clear, land, exit, undo, history, macro)
  • • The system automatically suggests macros for:
    • - Commands longer than 20 characters
    • - Commands with multiple operations (using &&)
  • • Maximum of 5 suggested macros at a time
  • • All macros are stored securely and persist across sessions
  • • Usage statistics are tracked for optimization

Safety Features

Kite is built with safety as a core principle:

Undo Command
$ kite "delete old downloads"
→ This action will delete files. Please confirm (y/n): y → Deleted 15 files → Type 'undo' to restore files
Permission Request
$ kite "optimize system performance"
→ This command requires system optimization permissions → Please grant access in System Preferences → See documentation for security details
  • • Every command can be undone with the 'undo' command
  • • API keys and sensitive data are stored securely in the system keychain
  • • Destructive actions always require explicit confirmation
  • • Clear feedback is provided for all operations
  • • Granular permission system for system access
  • • All actions are logged for audit purposes

Current Status

Free Version (Powered by Google Gemini)
macOS Support (10.13+)
Windows & Linux support (coming soon)
OpenAI-powered version (requires API KEY)

Available Versions

Standard

Gemini

Perfect for everyday automation and system management

Commands

Natural language processing with 85% accuracy

System Tasks

File operations and basic system optimization

Automation

Simple workflows and task automation

Advanced

OpenAI

Enhanced capabilities with OpenAI integration (API key required)

Commands

Advanced language understanding with 98% accuracy

System Tasks

Complex operations and deep system integration

Automation

Advanced workflows and batch processing

Command Examples

System Management

System Health
$ kite "show system health"
→ CPU Usage: 32% → Memory: 8.2 GB used of 16 GB → Storage: 234 GB free → Temperature: Normal
Optimization
$ kite "optimize my mac"
→ Clearing system cache... → Removing temporary files... → Optimizing startup items... → Performance improved by 15%
Disk Space
$ kite "clean up downloads folder"
→ Organizing files by type... → Moving old files to archive... → Freed up 2.1 GB of space

Development

Python Setup
$ kite "set up python environment"
→ Installing Python 3.11... → Setting up virtual environment... → Installing common packages... → Environment ready!
Dev Server
$ kite "start dev servers"
→ Starting frontend on port 3000 → Starting backend on port 8000 → Database connected → Ready for development!
React
$ kite "create new react project"

File Operations

Find Files
$ kite "find large video files"
→ Searching for videos >1GB... → Found 5 large videos: • Movies/inception.mp4 (2.3 GB) • Downloads/tutorial.mp4 (1.5 GB) • Desktop/screen-recording.mp4 (1.2 GB)
Organize
$ kite "organize downloads by type"
Backup
$ kite "backup important documents"

Tips & Tricks

  • • Use natural language - write commands as you'd explain them to someone
  • • Chain multiple actions - "backup photos and clean downloads folder"
  • • Type "kite help" to see all available commands
  • • Use "kite undo" to revert the last command
  • • Access settings anytime from the menu bar icon

Need Help?

Having issues or questions? Here's how to get help:

  • • Check settings in the menu bar icon
  • • Review logs if something breaks
  • • Switch between Gemini (free) and OpenAI in settings