Features Overview

Discover everything Astronox can do for you.

Interface & Customization

🌓 Light/Dark Mode

What It Is:

• Easy theme switching between light and dark modes
• Optimized contrast and readability in both modes
• Theme preference saved automatically
• Applies to entire interface instantly

How to Use:

1. Click ⚙️ Settings in the header
2. Look for Theme section
3. Select Light or Dark using radio buttons
4. Your choice is saved automatically

When to Use Each:

• Dark Mode: Better for low-light environments, reduces eye strain at night
• Light Mode: Better for bright environments, easier on the eyes during daytime work

What Changes:

• Chat interface and messages
• Sidebar and conversation list
• Settings panel and all modals
• Input composer and buttons
• Health checks panel
• All text and UI elements

Core Capabilities

🗂️ File & Folder Management

What You Can Do:

• List, search, and filter files across your system
• Read file contents (text, code, logs, etc.)
• Create, rename, move, delete files and folders
• Batch operations (process multiple files at once)
• Find duplicates, large files, unused files
• Organize files by type, date, size, or custom criteria

Example Use Cases:

"Find all PDFs larger than 5MB in my Documents"
"Organize my Downloads by file type"
"Delete temporary files older than 30 days"
"Find duplicate images in my Pictures folder"
"Create a folder structure for my new project"

Supported File Types:

• Documents: PDF, TXT, DOCX, MD
• Images: JPG, PNG, GIF, SVG (with vision analysis)
• Code: All programming languages
• Archives: ZIP, TAR, GZ
• Logs and data files

💻 System Control & Information

Monitor Your System:

• Check disk space, memory usage, CPU activity
• List running processes and their resource usage
• View network connections and speed
• Monitor battery and power status (laptops)
• Check system temperature and performance

Control Operations:

• Launch and kill applications
• Manage background processes
• Adjust system settings (brightness, volume, etc.)
• Power management (sleep, shutdown, restart)
• Clipboard history and management

Example Prompts:

"What's using all my memory?"
"Kill the process consuming most CPU"
"Show me disk space on all drives"
"List all running Chrome tabs"
"Increase brightness to 80%"

🔍 Intelligent Search & Analysis

File Content Search:

• Search text within files (grep-like functionality)
• Find code patterns across projects
• Locate files by content, not just name
• Regular expression support

Code Analysis:

• Understand code structure
• Find functions, classes, imports
• Identify potential bugs or improvements
• Explain complex code snippets

Data Extraction:

• Extract emails, URLs, phone numbers from documents
• Parse structured data (JSON, CSV, XML)
• Analyze logs for errors or patterns
• Generate reports from raw data

Example Uses:

"Find files containing 'TODO' in my projects folder"
"Search for all imports of 'react' in my code"
"Extract all email addresses from these documents"
"Analyze this log file for errors"

📊 Background Health Monitoring

Silent System Monitoring:

• Runs automatically every 30 minutes in the background
• Analyzes CPU, memory, disk, and process activity
• Detects suspicious processes and anomalies
• Monitors system crash reports
• Pauses during power-saving mode

Health Metrics Tracked:

• CPU usage percentage
• Memory utilization
• Disk space available per volume
• Running process count
• Process resource consumption

Smart Alerts:

• AI-generated health verdicts and recommendations
• Flags high-resource processes
• Detects unusual process behavior
• Identifies risky or suspicious activity
• Summarizes findings from system logs

Snapshot History:

• Local storage of all health check results
• Access snapshots anytime from Health Checks panel
• Review trends over time
• Clear data at any time
• No data sent to external servers

Example Insights:

"System health is good. Memory is stable at 65%. No suspicious processes detected."
"Warning: Disk space critically low (5% free). Recommend cleanup."
"Suspicious activity: Process 'miner.exe' flagged for high CPU and memory usage."
"Recent crash detected: Application ABC crashed 3 times in past 24 hours."

🤖 Automation & Scripting

Create Custom Scripts:

• Shell scripts (bash, zsh, PowerShell)
• Python automation scripts
• AppleScript (macOS)
• Batch files (Windows)

Save & Reuse:

• Save AI-generated scripts as "Automations"
• Run saved scripts with simple prompts
• Modify and improve scripts over time
• Schedule recurring tasks

Pre-built Automations:

• File organization workflows
• Backup scripts
• Data processing pipelines
• System maintenance tasks

Example Workflows:

"Create a script to backup my work folder daily"
"Write a Python script to rename files by date"
"Automate my project setup process"
"Generate a script to compress old files"

🖼️ Image & Visual Processing

Image Analysis:

• Describe image contents
• Extract text from screenshots (OCR)
• Identify objects, people, scenes
• Answer questions about images

Image Operations:

• Batch rename based on content
• Organize photos by detected content
• Find similar images
• Convert between formats

Supported Formats:

• JPG, PNG, GIF, WebP
• SVG (vector analysis)
• Screenshots and screen recordings

Example Tasks:

"What's in this screenshot?"
"Extract text from this image"
"Organize these photos by content"
"Find images containing people"

💾 Clipboard Management

Clipboard History:

• Track recent clipboard entries
• Search clipboard history
• Retrieve previously copied items
• Paste from history

Clipboard Operations:

• Read current clipboard content
• Write to clipboard programmatically
• Process clipboard data (transform, format, clean)
• Monitor clipboard for automation

Use Cases:

"What did I copy 5 minutes ago?"
"Save this to clipboard"
"Show my recent clipboard history"
"Format the clipboard text as JSON"

🧠 Memory & Context

Persistent Memory:

• Remember facts across conversations
• Store user preferences and context
• Build knowledge about your workspace
• Learn from repeated interactions

Categories:

• Personal information (name, preferences)
• Work context (projects, tools, workflows)
• Technical setup (languages, frameworks)
• Custom categories you define

Memory Operations:

"Remember that I prefer Python over JavaScript"
"What do you know about my work projects?"
"Forget everything about Project X"
"List all facts you've stored about me"

📋 Multi-Step Planning

Complex Task Execution:

• Break down large tasks into steps
• Visual progress tracking in Plan Hub
• Execute steps sequentially with confirmation
• Handle dependencies between steps

Plan Visibility:

• See all steps before execution
• Track progress in real-time
• Pause, resume, or cancel at any step
• Review completed steps

Example Multi-Step Tasks:

"Organize my entire Downloads folder:
  1. Find and delete temporary files
  2. Group remaining files by type
  3. Create dated archive folders
  4. Move old files to archive"

"Set up a new Python project:
  1. Create folder structure
  2. Initialize git repository
  3. Create virtual environment
  4. Install dependencies
  5. Generate README and .gitignore"

🔄 Real-Time Streaming

Live Updates:

• See AI responses as they're generated (not all at once)
• Real-time status updates during operations
• Progress indicators for long-running tasks
• Streaming command output

Benefits:

• Faster perceived response time
• Cancel operations mid-stream if needed
• Better feedback during complex tasks
• More responsive feel

🛡️ Safety & Confirmations

Risk Assessment:

• Automatic risk evaluation for all operations
• Visual warnings for dangerous actions
• Clear explanation of consequences
• Easy approve/deny buttons

Confirmation Levels:

• Low Risk: Executes immediately (read operations)
• Medium Risk: Asks in Safe Mode (file modifications)
• High Risk: Always confirms (deletions, system changes)
• Very High Risk: Extra warnings (bulk deletions, critical system changes)

What's Protected:

• File deletions
• System setting changes
• Process termination
• Bulk operations
• Irreversible actions

Advanced Features

🔗 Shell Command Execution

Direct Shell Access:

• Run any terminal command
• Execute with proper environment
• Capture output and errors
• Chain commands with pipes

Safety Features:

• Explains commands before running (Safe Mode)
• Shows expected output
• Prevents destructive typos
• Validates syntax

📝 Text & Code Generation

Content Creation:

• Generate code in any language
• Write documentation and README files
• Create configuration files
• Draft emails and messages
• Format and transform text

Code Assistance:

• Explain existing code
• Refactor and optimize
• Add comments and documentation
• Debug and fix errors
• Generate tests

🌐 Internet-Aware (Limited)

Current Capabilities:

• Access API keys from remote feeds (Pro)
• Check for app updates
• Validate license status

Not Yet Supported:

• General web browsing
• Real-time web search
• Downloading from URLs
• Online research

Platform-Specific Features

macOS Exclusive

• AppleScript automation
• Native system settings control
• Accessibility features integration
• Finder integration

Windows Exclusive

• PowerShell script generation
• Windows Registry (cautious, safe operations)
• Task Scheduler integration
• Explorer integration

What Astronox Cannot Do

Current Limitations:

• Cannot browse the internet actively
• Cannot send emails or messages directly
• Cannot control other apps' internal state (only launch/quit)
• Cannot access password managers or encrypted data
• Cannot make network requests (except to LLM APIs)
• Cannot modify files currently open in other apps

By Design:

• Does not store data in the cloud
• Does not share your conversations externally
• Does not access webcam or microphone
• Does not track your activity outside the app

Coming Soon

Features planned for future releases:

• Voice input and output
• Web browsing and research
• Email integration
• Calendar and task management
• Cloud sync (optional)
• Plugin/extension system
• Mobile companion app

Feature Comparison by Model

See Model Selection for detailed comparison.

Real-World Use Cases

For Developers

• Navigate and understand codebases
• Generate boilerplate and templates
• Debug errors and optimize code
• Automate build and deployment tasks
• Manage dependencies and environments

For Content Creators

• Organize media libraries
• Batch process files (rename, convert, resize)
• Extract data from documents
• Generate scripts and workflows
• Manage project files

For Power Users

• Advanced file management
• System optimization and cleanup
• Custom automation scripts
• Data analysis and reporting
• Multi-step workflow automation

For Casual Users

• Find and organize files
• Clean up disk space
• Answer questions about your system
• Simple automation (backups, organization)
• Learn about your computer

Getting the Most From Features

Start Simple:
Begin with basic file operations, then gradually explore automation and advanced features.

Combine Features:
Use memory + plans + automation together for powerful workflows.

Experiment Safely:
Use Safe Mode while learning; switch to Full Mode when confident.

Ask for Help:
Astronox can explain its own capabilities: "How do I use the memory feature?"

Next: Learn about the UI Components to navigate these features effectively.