Null Terminal User Guide¶

Null Terminal is a block-based terminal emulator with integrated multi-provider AI chat and autonomous agent capabilities. It bridges the gap between traditional CLI tools and modern AI assistance.

Quick Start¶

# Run the application
uv run main.py

# Or if installed
null-terminal

Core Concepts¶

Block-Based Interface¶

Every command and AI interaction creates a distinct "block" in the terminal: - Command Blocks: Shell command execution with output - AI Response Blocks: Chat responses with metadata (tokens, cost) - Agent Blocks: Multi-step autonomous task execution - System Blocks: Status messages and notifications

Two Modes¶

• CLI Mode (default): Execute shell commands directly
• AI Mode: Chat with your configured AI provider

Toggle between modes with Ctrl+Space or /ai.

Agent Capabilities¶

Enable autonomous task execution where the AI can: - Execute shell commands and file operations - Plan Complex Tasks: Create roadmaps with /plan - Git Integration: Auto-commit changes with generated messages - Use MCP Tools: Connect to external services (databases, cloud, etc.) - Orchestrate Workflows: Run multi-agent tasks

Toggle agent mode with /agent.

Essential Shortcuts¶

Feature Highlights¶

• Planning Mode: Review and approve AI plans before execution. Learn more
• Git Operations: Seamless integration with git workflows. Learn more
• Workflows & Agents: Save sessions and run background tasks. Learn more
• MCP Integration: Connect 100+ external tools. Learn more

Documentation¶

• Commands Reference - All slash commands
• Keyboard Shortcuts - All keyboard shortcuts
• AI Providers - Setting up AI providers
• Planning Mode - Task planning and execution
• Git Operations - Version control integration
• Workflows & Agents - Templates and multi-agent tasks
• MCP Servers - Model Context Protocol setup
• Configuration - Settings and options
• Themes - Customizing appearance
• Tools & Agent Mode - AI tool use
• Sessions - Saving and loading sessions

File Locations¶