Cosmonaut Launcher

CLI and menu bar applet for GitHub Codespaces + 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, select a codespace, open 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

• gh authenticated (gh auth login)
• zed installed
• SSH server in your codespace image (ghcr.io/devcontainers/features/sshd:1)