# Dropstone Documentation - Complete Reference
# https://docs.dropstone.io
# Last Updated: 2025-12-29

================================================================================
DROPSTONE AGENT - AI CODING ASSISTANT
================================================================================

Dropstone Agent is an autonomous AI coding assistant powered by the D3 Engine,
built directly into Dropstone Desktop. It provides intelligent code analysis,
automated task execution, and context-aware development support across 40+
programming languages.

Developed by: Blankline Research
Website: https://www.dropstone.io
Documentation: https://docs.dropstone.io

================================================================================
GETTING STARTED
================================================================================

## Installation

### Windows
1. Download from https://www.dropstone.io/downloads
2. Run the installer
3. Launch Dropstone Desktop
4. Login or create account

### macOS (Apple Silicon)
1. Install Homebrew if not installed:
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Add Homebrew to PATH:
   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
   eval "$(/opt/homebrew/bin/brew shellenv)"

3. Install Dropstone:
   brew tap blankline-org/dropstone
   brew install --cask dropstone

4. Grant Full Disk Access in System Settings → Privacy & Security

## First Steps
1. Open Dropstone Desktop
2. Login with your Dropstone account
3. Open a project folder
4. Start chatting with the agent in natural language
5. Use Horizon Mode (Pro feature) via Horizon menu → Open Horizon

================================================================================
AGENT MODES
================================================================================

Dropstone has two types of modes:
1. Agent Modes - How the AI thinks (Code, Debug, Architect, Ask, Orchestrator)
2. View Modes - How the interface displays (Horizon Mode, Editor Mode)

## Code Mode (Default)
- Full file creation, modification, and deletion
- Refactoring and feature implementation
- Test generation
- Best for: Writing and modifying code

## Debug Mode
- Root cause analysis with hypothesis generation
- Error investigation and fix verification
- Semantic search for related issues
- Best for: Finding and fixing bugs
- Activate: @mode debug or ask about errors

## Architect Mode
- System design with visual diagrams (Mermaid)
- Markdown-only file editing
- Architecture planning and documentation
- Best for: Planning and design
- Activate: @mode architect or ask for design help

## Ask Mode
- Read-only code access
- Technical explanations
- Research and learning
- Best for: Understanding code without changes
- Activate: @mode ask or ask questions

## Orchestrator Mode
- Multi-mode workflow coordination
- Task delegation to appropriate modes
- Strategic planning
- Best for: Complex multi-step projects
- Activate: @mode orchestrator or describe complex project

## Horizon Mode (Pro Feature)
- Full-screen distraction-free AI workspace
- Personalized greeting based on time of day
- Dedicated conversation history
- Access: Horizon menu → Open Horizon
- Return: Editor Layout menu → Open Editor, or click status bar indicator
- Requires: Pro, Teams, or Enterprise subscription

================================================================================
PRICING
================================================================================

## Free Tier
- 50 Fast Requests per day
- Unlimited Local Models (Ollama)
- Horizon Mode: DISABLED (Linear Inference Only)
- 5 Active Share Links (24h TTL)

## Pro - $15/month
- Unlimited Local & Fast Models
- ~750 Frontier Requests (Claude 4.5 Sonnet, GPT 5.2)
- Horizon Architecture: Scout Swarm ACTIVE
- Adversarial Monitor: L1-L2 Verification
- Memory Manifold with Personal Weights
- Unlimited Share Links (30-day TTL)

## Teams - $75/user/month
- ~2,250 Frontier Requests (3x Allowance)
- Pooled Team Credits
- Horizon Full Stack with L3-L4 Verification
- Flash Protocol: ACTIVE (Instant Pruning)
- Negative Knowledge: ACTIVE (Shared Failure Vectors)
- Distributed Knowledge Mesh
- Real-time Collaborative Editing
- SSO/SAML Integration
- Advanced Audit Logging

## Enterprise
- Requires Blankline Research Integrity Council approval
- Enterprise I: 10k Agents (Industrial hive topology)
- Enterprise II: 1k Agents (Mesh topology)
- Dense Frontier: Dynamic (D-Series reasoning, Council Ratification required)
- 4-phase sequence: Submission → Verification → Provisioning → Activation
- Contact: https://www.dropstone.io/contact

================================================================================
KEY FEATURES
================================================================================

## D3 Engine
- Semantic code understanding across 40+ languages
- AST (Abstract Syntax Tree) parsing
- Dependency graph analysis
- Impact analysis for changes

## Memory System
- Episodic Memory: Conversation history
- Semantic Memory: Code patterns and concepts
- Procedural Memory: Learned workflows
- Working Memory: Active context

## Self-Learning
- Pattern recognition from successful tasks
- Confidence-based learning
- Adapts to your coding style over time

## Context Mentions
- @file - Reference specific files
- @folder - Reference directories
- @url - Include web documentation
- @problems - Reference VS Code errors
- @terminal - Include terminal output

## Keyboard Shortcuts
- Ctrl+L / Cmd+L: Add code to context
- Ctrl+Shift+A / Cmd+Shift+A: Open Chat
- Ctrl+Shift+P / Cmd+Shift+P: Command Palette
- Ctrl+. / Cmd+.: Switch Mode

================================================================================
TOOLS & COMMANDS
================================================================================

## File Operations
- read_file: View file contents
- write_to_file: Create or overwrite files
- delete_file: Remove files
- list_files: Directory listing with patterns
- search_files: Regex search across files

## Code Editing
- apply_diff: Apply unified diff patches
- insert_content: Insert at specific line
- search_and_replace: Find and replace

## Code Analysis
- semantic_search: Find conceptually related code
- ast_parse: Extract structural information
- analyze_dependencies: Map import relationships
- find_component_usages: Find all usages
- analyze_impact: Assess change impact

## Terminal & Browser
- execute_command: Run terminal commands
- browser_action: Browser automation

## MCP Integration
- use_mcp_tool: Use MCP server tools
- access_mcp_resource: Access MCP resources

================================================================================
CUSTOM MODES
================================================================================

Create custom modes via .dropstone-modes file:

{
  "customModes": [
    {
      "slug": "test",
      "name": "Test Mode",
      "roleDefinition": "You are a Jest testing specialist...",
      "groups": ["read", ["edit", { "fileRegex": ".*\\.(test|spec)\\." }]],
      "customInstructions": "Focus on test coverage..."
    }
  ]
}

Built-in Custom Modes:
- Test: Jest testing specialist
- Translate: Localization and i18n
- Design Engineer: UI/UX development
- Release Engineer: Release automation

================================================================================
TROUBLESHOOTING
================================================================================

## Common Issues

### macOS Installation
- Homebrew not found: Install from brew.sh
- Tap not found: Run "brew update" first
- Permission denied: Grant Full Disk Access

### Ollama Setup
- Check Ollama running: curl http://localhost:11434
- Default URL: http://localhost:11434
- Pull models: ollama pull llama3.2

### Performance
- Reduce context window size in settings
- Use smaller models for faster responses
- Close unused browser sessions

## Log Locations
- Windows: %APPDATA%\Dropstone\logs
- macOS: ~/Library/Application Support/Dropstone/logs
- Linux: ~/.config/Dropstone/logs

## Reset Settings
Delete config file and restart:
- Windows: %APPDATA%\Dropstone\config.json
- macOS: ~/Library/Application Support/Dropstone/config.json

================================================================================
CONTACT & SUPPORT
================================================================================

Website: https://www.dropstone.io
Documentation: https://docs.dropstone.io
Downloads: https://www.dropstone.io/downloads
Contact Sales: https://www.dropstone.io/contact
Enterprise: Contact Blankline Research Integrity Council

================================================================================