FudiFox

FudiFox

A powerful macOS productivity app with AI integration

Fast search, custom workflows, and AI-powered automation at your fingertips

Download View on GitHub

Features

⚡

Lightning Fast Search

Spotlight-like interface with instant file, app, and workflow search. Press ⌘Space to launch.

🤖

AI Integration

Built-in support for Claude and ChatGPT APIs with intelligent function calling and context-aware responses.

🔄

Custom Workflows

Create and automate complex multi-step workflows to streamline your daily tasks.

🔧

Developer Tools

GitHub search, Jira integration, system info, process management, and more built-in functions.

📋

Clipboard Manager

Access your clipboard history instantly with ⌘P and never lose copied content.

🎨

Extensible

Easy to add new search providers, AI functions, and customize to your workflow.

User Guide

Installation

  1. Download the latest release from GitHub Releases
  2. Open the downloaded .dmg file
  3. Drag FudiFox to your Applications folder
  4. Launch FudiFox from Applications
  5. Grant necessary permissions when prompted (Accessibility, File System)
System Requirements:
  • macOS 13.0 (Ventura) or later
  • Apple Silicon or Intel processor
⚠️ Security Notice - First Launch

FudiFox is currently not code-signed with an Apple Developer ID. macOS Gatekeeper may show a security warning or display "FudiFox is damaged and can't be opened. You should move it to the Trash."

This is NOT because the app is actually damaged - it's a security measure by macOS for unsigned apps.

Solution 1: Remove Quarantine Attribute (Recommended)

Run this command in Terminal to allow FudiFox to run:

xattr -cr /Applications/FudiFox.app

Then launch FudiFox normally from Applications or Spotlight.

Solution 2: Manual Security Override

  1. First attempt - Right-click method:
    • Right-click on FudiFox.app in Finder
    • Select "Open" from the context menu
    • Click "Open" in the security dialog
  2. If that fails - System Preferences:
    • Go to System Settings → Privacy & Security → General
    • Look for the FudiFox block message
    • Click "Open Anyway"
  3. Last resort - Disable Gatekeeper temporarily: 
    # Disable Gatekeeper
sudo spctl --master-disable

# Open FudiFox once
open /Applications/FudiFox.app

# Re-enable Gatekeeper (recommended for security)
sudo spctl --master-enable

Why This Happens

Apple requires apps distributed outside the Mac App Store to be code-signed with a valid Developer ID ($99/year) and notarized by Apple's notarization service. FudiFox is currently unsigned to keep it free and open-source.

Basic Usage

  1. Launch FudiFox: Press ⌘Space (customizable)
  2. Search: Start typing to search files, apps, or workflows
  3. Navigate: Use arrow keys ↑↓ to move through results
  4. Execute: Press Enter to run the selected item
  5. Quick Select: Press ⌘1-⌘9 to select items directly
  6. Close: Press Esc to dismiss

AI Features

Prefix your query with ? or ai: to use AI:

? What's the weather in San Francisco?
ai: Find Swift UI repositories on GitHub
? Create a Jira ticket for bug fix
Setup AI API Keys:

Add to your ~/.zshrc or ~/.bash_profile:

export CLAUDE_API_KEY="your_key_here"
export OPENAI_API_KEY="your_key_here"

Built-in Functions

  • github_search: Search repositories, issues, create PRs
  • jira_operations: Search and create Jira tickets
  • system_info: Hardware, memory, disk, process info
  • file_operations: List, search, and read files
  • process_management: List, find, and kill processes

Permissions

FudiFox requires the following macOS permissions to function properly:

  • Accessibility Access: For global keyboard shortcuts
  • File System Access: For file search functionality
  • Network Access: For AI API calls

You'll be prompted to grant these when first launching the app. You can also manually grant them in System Settings → Privacy & Security.

Keyboard Shortcuts

Global Shortcuts

⌘Space Launch FudiFox search
⌘G Google search
⌘F Ask AI
⌘H Search history
⌘P Clipboard history
⌘, Open settings
⌘Q Quit FudiFox

In-App Navigation

↑ ↓ Navigate results
Enter Execute selected item
⌘1-⌘9 Quick select items 1-9
Esc Close window
⌘A Select all text
⌘C Copy text
⌘V Paste text
⌘X Cut text
Note: All shortcuts are customizable in FudiFox settings (⌘,)

Support

🐛

Report Issues

Found a bug or have a feature request?

GitHub Issues
📧

Email Support

Need help or have questions?

fudifox.app@gmail.com
📖

Documentation

Learn more about building from source

View Documentation

Frequently Asked Questions

How do I change the global shortcut?

Open FudiFox settings with ⌘, and customize the global shortcut in the Shortcuts tab.

Where are workflows stored?

Workflows are stored in ~/Library/Application Support/FudiFox/workflows.json

Why aren't my keyboard shortcuts working?

Make sure you've granted Accessibility permissions to FudiFox in System Settings → Privacy & Security → Accessibility.

Can I use FudiFox without AI features?

Yes! All core search and workflow features work without AI. AI features are optional and only activated when you use the ? or ai: prefix.