Skip to content

zphiliam/cosmos

Repository files navigation

Cosmos

Cosmos

The file manager macOS deserves.

A blazing-fast, native file manager built with Go and React.
Dual panes. Tabs. Powerful search. Remote connections. No Electron.

FeaturesInstallationShortcutsRoadmap


Why Cosmos?

Finder is beautiful but limited. Cosmos gives you the power tools you've been missing:

Finder Cosmos
Dual pane view Open 2 windows Built-in
Tabs Limited Unlimited
Search Slow, full disk Instant fuzzy + regex + content
Command Palette - ⌘K
Undo operations Limited Full history
Remote connections - SFTP / FTP / FTPS
Git status - Per-file indicators
Batch rename - 5 modes + preview
File comparison - Text diff + folder diff

Features

Core Navigation

  • Dual Pane — Work with two directories side by side
  • Unlimited Tabs — Open as many folders as you need
  • Column View — Finder-style hierarchical navigation
  • Quick Look — Space to preview 50+ file formats

Powerful Search

  • Spotlight Search (⌘P) — Smart search with live preview
  • Fuzzy Matching — Find files without exact names
  • Regex Support — Advanced pattern matching
  • Content Search — Search inside files (grep-style)
  • Type Filters — Quick filter by Code/Docs/Images/Videos

File Operations

  • Drag & Drop — Between panes, to/from desktop
  • Batch Rename — Replace, sequence, regex, case change, extension
  • Compress/Extract — ZIP, TAR, GZ, BZ2
  • Undo (⌘Z) — Restore deleted, moved, or renamed files
  • Operation History — View and undo past actions

Remote Connections

  • SFTP — SSH key & password authentication
  • FTP / FTPS — Secure FTP with TLS
  • SSH Config Import — Auto-detect from ~/.ssh/config
  • Transfer Queue — Upload/download with progress
  • Remote Preview — View files without downloading

Developer Tools

  • Git Integration — File status (M/A/D/?), branch info
  • Open in Terminal — Jump to any folder in Terminal.app
  • File Comparison — Side-by-side text diff, folder structure diff
  • Symlink Support — Navigate links, detect broken ones

Native Experience

  • Command Palette (⌘K) — Access any action instantly
  • macOS Tags — Read/write Finder color tags
  • System Icons — Shows actual app icons (.psd, .sketch, etc.)
  • Dark/Light Theme — Follows system preference

Installation

Download

Download the latest release from Releases.

Build from Source

# Prerequisites: Go 1.21+, Node.js 18+, Wails CLI
# Install Wails: go install github.com/wailsapp/wails/v2/cmd/wails@latest

git clone https://github.com/zphiliam/cosmos.git
cd cosmos
wails build

The app will be in build/bin/.

Keyboard Shortcuts

Essential

Shortcut Action
⌘K Command Palette
⌘P Spotlight Search
Space Quick Look preview
Enter Open file/folder
⌘O Open with default app
F2 Rename
⌘Z Undo last operation

Navigation

Shortcut Action
⌘↑ Go to parent folder
⌘1-9 Jump to bookmark 1-9
⇧⌘H Go to Home
⇧⌘F Show in Finder
Tab Switch active pane
⌘\ Toggle dual pane

File Operations

Shortcut Action
⌘C / ⌘X / ⌘V Copy / Cut / Paste
⌘⌫ Move to Trash
⌘A Select all
⇧⌘R Batch rename
⇧⌘D Compare files
⌘I Get info

Tabs & Views

Shortcut Action
⌘T New tab
⌘W Close tab
⇧⌘S Toggle sidebar
Ctrl+1-7 Set color tag
Ctrl+0 Clear tags

Tech Stack

  • Backend: Go 1.21+ with Wails v2
  • Frontend: React 18 + TypeScript + Vite
  • UI: Tailwind CSS + Radix UI (shadcn/ui style)
  • State: Zustand
  • Virtual List: @tanstack/react-virtual

No Electron. Native WebView. ~150MB memory. <1s cold start.

Roadmap

  • Dual pane + tabs
  • Search (fuzzy, regex, content)
  • Command Palette
  • SFTP / FTP connections
  • Git integration
  • Batch rename
  • Undo / History
  • File comparison
  • iCloud status
  • Cloud storage (Google Drive, Dropbox)
  • Plugin system
  • i18n (English, Chinese, Japanese)

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting a PR.

# Development
wails dev

# Build
wails build

# Regenerate Wails bindings after Go API changes
wails generate module

License

MIT License - see LICENSE for details.


Built with ❤️ for power users who deserve better than Finder.

About

A modern, powerful file manager for macOS that goes beyond Finder. Built with Wails, Go & React.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors