📖 Complete Command Reference

60+ built-in commands organized by category

🤖 Core AI Commands

djinn "prompt"

Convert natural language to shell commands.

djinn "list all files larger than 100MB"
djinn "find Python files modified today"
djinn "show disk usage sorted by size"
djinn "create a new React component called Button"

djinn -i / --interactive

Start interactive chat mode for multi-turn conversations.

djinn -i
djinn --interactive

djinn explain "command"

Get detailed explanation of any shell command.

djinn explain "git rebase -i HEAD~5"
djinn explain "find . -name '*.py' -mtime +30 -delete"

djinn suggest

Get context-aware command suggestions based on your directory.

djinn suggest

djinn redo

Regenerate the last command with a different approach.

djinn redo

djinn translate "cmd" --to <shell>

Translate commands between shells (bash/powershell/zsh).

djinn translate "ls -la" --to powershell
djinn translate "Get-ChildItem" --to bash

djinn why "error"

Explain WHY a command failed with solutions.

djinn why "permission denied"
djinn why "command not found"
djinn why "connection refused"

🖥️ TUI Commands

Full-screen interactive terminal interfaces. See detailed TUI docs →

djinn dashboard

Launch full-screen system monitor (CPU, RAM, Disk, Network, Processes).

djinn dashboard
# Press Ctrl+C to exit

djinn explore [path]

Interactive file explorer.

djinn explore
djinn explore /var/log
djinn explore ~/projects

djinn db <action> [args]

Database viewer for SQLite, PostgreSQL, MySQL.

djinn db connect
djinn db connect mydb.sqlite
djinn db tables mydb.sqlite
djinn db query mydb.sqlite "SELECT * FROM users LIMIT 10"
djinn db info mydb.sqlite

djinn http <method> <url>

HTTP client for API testing.

djinn http get https://api.github.com
djinn http post https://api.example.com -d '{"name":"John"}'
djinn http get https://api.example.com -H "Authorization:Bearer token"

djinn pkg <action> [package]

Universal package manager (npm/pip/cargo/go/gem).

djinn pkg info
djinn pkg install react
djinn pkg install flask -D
djinn pkg list
djinn pkg outdated

⚡ Automation

djinn flow <action> [name]

Multi-step workflow automation.

djinn flow templates          # List built-in templates
djinn flow create my-deploy   # Create new workflow
djinn flow list               # List your workflows
djinn flow run my-deploy      # Execute workflow
djinn flow run ci --dry-run   # Preview without executing
djinn flow delete old-flow    # Delete workflow

djinn schedule <action> [args]

Schedule commands for later execution.

djinn schedule add "npm test" +1h      # Run in 1 hour
djinn schedule add "backup" +30m       # Run in 30 minutes
djinn schedule add "cleanup" +1d       # Run tomorrow
djinn schedule list                    # List pending tasks
djinn schedule run                     # Execute due tasks
djinn schedule cancel task-123         # Cancel task

djinn voice [--listen]

Voice control for terminal commands.

djinn voice             # Single voice command
djinn voice --listen    # Continuous listening mode

Supported phrases: "list files", "git status", "docker containers", "run tests"

📝 Documentation

djinn docs <action> [file]

Auto-generate documentation.

djinn docs readme           # Generate README for project
djinn docs script file.py   # Document a script
djinn docs api module.py    # Generate API docs

djinn record <action> [name]

Record terminal sessions.

djinn record start my-session   # Start recording
djinn record stop               # Stop and save
djinn record list               # List recordings
djinn record export my-session  # Export as script
djinn record delete my-session  # Delete recording

djinn gist "content"

Share as GitHub Gist.

djinn gist "my awesome script"
# Requires GITHUB_TOKEN environment variable

djinn review [file] [--staged]

AI-powered code review.

djinn review              # Review uncommitted changes
djinn review --staged     # Review staged only
djinn review file.py      # Review specific file

🌿 Environment

djinn env <action> [args]

Manage .env files.

djinn env list              # List variables (masks secrets)
djinn env get API_KEY       # Get variable value
djinn env set API_KEY value # Set variable
djinn env delete API_KEY    # Remove variable
djinn env backup            # Backup .env
djinn env validate          # Check for issues

djinn dotfiles <action>

Backup and restore dotfiles.

djinn dotfiles backup     # Backup .bashrc, .gitconfig, etc.
djinn dotfiles restore    # Restore from backup
djinn dotfiles list       # List backed up files
djinn dotfiles export     # Export as tar.gz

djinn setup <action> [template]

Quick project setup.

djinn setup list          # List templates
djinn setup new node      # Node.js project
djinn setup new python    # Python project
djinn setup new fastapi   # FastAPI API
djinn setup new express   # Express.js API

djinn ssh <action> [args]

SSH connection manager.

djinn ssh list                    # List saved connections
djinn ssh add server host user    # Add connection
djinn ssh connect server          # Get connect command
djinn ssh keys                    # List SSH keys

🎯 Productivity

djinn learn <action> [args]

Learn from your patterns.

djinn learn status                      # View learning status
djinn learn shortcut                    # List shortcuts
djinn learn shortcut add deploy "..."   # Add shortcut
djinn learn insights                    # Usage insights

djinn predict

Predictive command suggestions based on history.

djinn predict

djinn cheat <tool> [search]

Built-in cheatsheets.

djinn cheat git               # Git cheatsheet
djinn cheat docker            # Docker cheatsheet
djinn cheat git search rebase # Search in cheatsheet

Available: git, docker, kubernetes, linux, npm, python, aws, postgres

djinn notify "message"

Desktop notifications.

djinn notify "Build complete!"
djinn notify "Error occurred" --error

🔧 DevOps

djinn compose <action>

Docker Compose generator.

djinn compose templates       # List templates
djinn compose generate        # Generate from AI
djinn compose from-template wordpress

djinn scan

Dependency vulnerability scanner.

djinn scan                    # Scan current project
djinn scan --fix              # Auto-fix issues

djinn release <action>

Git release automation.

djinn release version         # Show current version
djinn release bump patch      # Bump patch version
djinn release bump minor      # Bump minor version
djinn release bump major      # Bump major version
djinn release tag             # Create and push tag

djinn architect <action> [args]

Project architecture generator.

djinn architect list                          # List templates
djinn architect stacks                        # Quick stacks
djinn architect create fullstack-react-node myapp

⚙️ Configuration

djinn config <action> [args]

Manage DJINN configuration.

djinn config show                 # Show all settings
djinn config set provider ollama  # Set LLM provider
djinn config set model llama3.2   # Set model
djinn config reset                # Reset to defaults

djinn theme <action> [name]

UI theme management.

djinn theme list              # List themes
djinn theme set cyberpunk     # Set theme

Available: default, cyberpunk, retro, nord, dracula, solarized, monokai, light

djinn model <action> [name]

LLM model management (Ollama).

djinn model list              # List installed models
djinn model browse            # Browse available
djinn model download llama3   # Download model
djinn model delete codellama  # Remove model
djinn model info llama3       # Model details
djinn model recommend         # Recommendations for your hardware

djinn sync <action>

Export/import DJINN settings.

djinn sync export             # Export to file
djinn sync import file.json   # Import from file
djinn sync share              # Create shareable link

🎮 Fun & Games

djinn game <type>

Educational games.

djinn game typing     # CLI typing practice
djinn game quiz       # CLI knowledge quiz
djinn game memory     # Command memory game

djinn speak "message"

Text-to-speech.

djinn speak "Hello world"
djinn speak "Build complete"