Cosmonaut Launcher

CLI and menu bar applet for GitHub Codespaces or Coder workspaces + Zed.

Documentation · Configuration · API Reference

Install

macOS

Download the .dmg from Releases, open it, and drag to Applications.

Linux

Download the .AppImage from Releases:

chmod +x cosmonaut-*.AppImage
./cosmonaut-*.AppImage

Nix

{
  inputs.cosmonaut.url = "github:linuskendall/cosmonaut";
}

Or with Home Manager for declarative config + auto-start.

Quick start

# Launch interactively: pick a repo/workspace and open it in Zed
cosmonaut

# Or use a named target from your config
cosmonaut work

# Start the menu bar applet (tray icon, hotkey, lifecycle management)
cosmonaut applet

Requirements

• One workspace provider CLI:
  • gh authenticated (gh auth login) for GitHub Codespaces
  • coder authenticated (coder login) for Coder
• zed installed
• SSH access enabled in your remote workspace image