Magic Box: Intelligent Content Detection That Learns Your Workflow

The Magic Box is the heart of Spoold - an intelligent content detection system that instantly recognizes what you paste and shows you the right tool. But it's more than just detection: it learns from your patterns and suggests workflows to make you faster.

What is Magic Box?

Magic Box is our smart input system on the homepage. Simply paste any content - JSON, HTML, curl commands, JWT tokens, CSV data, regex patterns, timestamps, Base64 strings, and more - and it automatically detects the format and suggests the perfect tool.

Instant Detection: 20+ Content Types

Magic Box can detect and handle a wide variety of content formats:

Data Formats

• JSON: Standard JSON, escaped JSON, URL-encoded JSON, JSON5, NDJSON
• YAML: YAML configuration files and data
• CSV/TSV: Comma or tab-separated values
• XML: XML documents and data

Web & API Formats

• HTML: HTML documents, fragments, and code
• Markdown: Markdown text and documentation
• curl: HTTP curl commands with headers and data
• URLs: Full URLs with query parameters

Security & Encoding

• JWT: JSON Web Tokens (header.payload.signature)
• Base64: Base64-encoded strings, images, PDFs
• Hex: Hexadecimal encoded data
• Unicode: Unicode escape sequences
• Binary: Binary data representations
• Gzip: Compressed gzip data

Text & Patterns

• Regex: Regular expression patterns
• Timestamps: Unix timestamps (seconds/milliseconds), ISO dates
• Plain Text: Fallback for unrecognized content

How Detection Works

Magic Box uses intelligent pattern matching with confidence scoring:

1. Pattern Recognition

Each content type has specific patterns and signatures:

• JSON: Validates structure, checks for braces/brackets, detects escaped strings
• JWT: Three-part structure separated by dots (header.payload.signature)
• curl: Detects HTTP methods, headers, and data payloads
• Base64: Character set validation and length checks
• Timestamps: Validates date ranges (1970-2100) for Unix timestamps

2. Confidence Scoring

Each detection includes a confidence score (0-1):

• High Confidence (0.9+): JWT tokens, valid JSON, Unix timestamps
• Medium Confidence (0.7-0.9): HTML, Markdown, YAML, regex patterns
• Lower Confidence (0.6-0.7): Generic Base64, ambiguous formats

3. Multi-Format Detection

Magic Box can detect multiple formats in a single input:

• curl command containing JSON data → suggests both curl converter and JSON formatter
• JSON with Base64-encoded images → detects JSON structure and Base64 content
• JWT token in a curl request → identifies both JWT and HTTP request

Learning & Adaptation

Magic Box doesn't just detect - it learns from your usage patterns:

Pattern Learning

When you select a tool for specific content, Magic Box remembers:

• Input patterns (structure, length, characteristics)
• Your tool preferences for similar content
• Common workflows you follow

Workflow Suggestions

Based on your history, Magic Box suggests:

• Next Tools: "After formatting JSON, you usually convert to YAML"
• Common Sequences: "Users often decode JWT after viewing curl commands"
• Contextual Tips: Helpful hints based on what you're working with

Enhanced Detection

Over time, Magic Box improves its suggestions:

• Learns your preferred tools for ambiguous content
• Adapts to your workflow patterns
• Provides personalized suggestions

Using Magic Box Effectively

1. Paste and Detect

Simply paste your content into the Magic Box. Detection happens instantly as you type or paste.

2. Review Suggestions

Magic Box shows 2-4 suggested actions as clickable chips:

• Primary action (highest confidence match)
• Alternative tools for the same content
• Related workflows (e.g., "Format then Convert to YAML")

3. Keyboard Shortcuts

• 1-9: Select suggestion by number
• Cmd/Ctrl + Enter: Run the first suggestion
• Esc: Clear input and reset
• Cmd/Ctrl + K: Open tool picker

4. Learn Your Patterns

The more you use Magic Box, the smarter it gets:

• It remembers which tools you prefer for specific content
• Suggests workflows based on your history
• Adapts to your development style

Real-World Examples

Example 1: API Response

Paste a JSON API response:

{
  "user": {
    "id": 123,
    "name": "John",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

Magic Box detects:

• ✅ JSON structure (high confidence)
• ✅ JWT token within JSON (high confidence)
• Suggestions: Format JSON, Decode JWT, Convert to YAML

Example 2: curl Command

Paste a curl command:

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer token123" \
  -d '{"name": "John", "email": "john@example.com"}'

Magic Box detects:

• ✅ curl command (high confidence)
• ✅ JSON in request body (high confidence)
• Suggestions: Convert to fetch/axios, Format JSON, Decode JWT (if token present)

Example 3: Timestamp

Paste a Unix timestamp:

1704067200

Magic Box detects:

• ✅ Unix timestamp in seconds (high confidence)
• Suggestions: Convert to date, Convert to ISO format

Benefits

• Save Time: No need to manually find the right tool
• Reduce Errors: Automatic detection prevents wrong tool selection
• Learn Workflows: Discover new ways to use tools together
• Adaptive: Gets smarter with your usage patterns
• Keyboard-First: Fast navigation without mouse

Privacy & Performance

• Local Processing: All detection happens in your browser - no data sent to servers
• Fast Detection: Instant results using efficient pattern matching
• Learning Storage: Patterns stored locally in your browser (IndexedDB)
• No Tracking: Your content and patterns stay private

Best Practices

• Paste complete content for better detection accuracy
• Use keyboard shortcuts for faster navigation
• Let Magic Box learn your patterns over time
• Review suggestions to discover new workflows
• Use the tool picker (Cmd/Ctrl+K) for manual selection

Future Enhancements

We're continuously improving Magic Box:

• More content type detections
• Smarter workflow suggestions
• Multi-step workflow automation
• Team pattern sharing (optional)

Experience intelligent content detection with our Magic Box - paste anything and watch it instantly detect and suggest the perfect tool. The more you use it, the smarter it gets!