The honest guide to installing Hyperion, opening your first workspace, and understanding what is shipped today versus what is still being built.
Hyperion is an open-source desktop workspace for developers who work across projects, terminals, and AI coding tools. Its goal is to replace scattered terminal windows and browser tabs with one project-scoped command center.
Version 1 establishes the workspace and terminal foundation. Agent execution, kanban dispatch, Prompt Forge, and coordinated swarms are at different stages of development; their status is documented below instead of being presented as finished.
Note
Hyperion-Workspace/Hyperion repository.Use the one-line installer for the fastest setup. It detects your platform, resolves the latest GitHub release, installs the application, and registers the hyperion command.
Works on Linux and macOS. It also supports WSL, Git Bash, MSYS, and Cygwin when their required Unix tools are available.
curl -fsSL https://www.hyperions.bond/install.sh | bashRuns the native Windows installer through PowerShell 5.1 or newer and registers Hyperion for the current user.
powershell -c "irm https://www.hyperions.bond/install.ps1 | iex"Downloads the Windows command launcher, which performs a preflight check and hands installation to PowerShell.
curl -fsSL https://www.hyperions.bond/install.cmd -o install.cmd && install.cmdTip
Detects the operating system, CPU architecture, shell, and required download or extraction tools.
Queries the official GitHub release channel and selects the latest compatible application package.
Downloads and unpacks Hyperion into a user-writable application or command directory.
Registers the hyperion command and adds a desktop or Start Menu entry where the platform supports it.
Existing configuration is preserved. On Linux and macOS the default configuration lives at ~/.config/hyperion. Windows installs command files under the current user's local application data directory.
Note
Open a fresh terminal after installation so PATH changes are available, then launch Hyperion:
# Start Hyperion from a terminal
hyperion
# If the command is not found, open a new terminal first▋Warning
Keep projects separated in the workspace sidebar. Switching projects re-scopes the active workspace instead of mixing unrelated work.
Run project commands inside Hyperion with real terminal panes instead of juggling separate terminal windows.
Split, resize, and organize terminal panes into a layout that matches the project you are working on.
Hyperion v1.0.0 ships release artifacts for Windows, macOS, and Linux through GitHub Releases.
Hyperion is moving quickly. This table follows the application repository's current roadmap and avoids treating prototypes or planned concepts as production features.
| Status | Capability | Meaning |
|---|---|---|
| Shipped | Multi-workspace sidebar and scoped state | Create, switch, and isolate project workspaces. |
| Shipped | Terminal grid | Split, resize, and organize terminal panes. |
| In progress | Agent lifecycle | Spawn agents, stream output, and stop or restart sessions. |
| In progress | Task board and agent dispatch | Assign work from a kanban board and follow execution status. |
| Planned | Prompt Forge | Version, compare, and reuse prompts inside a workspace. |
| Planned | Dependency-aware agent swarm | Coordinate dependent tasks across multiple agents. |
| Planned | Plugin system | Extend Hyperion with custom agent and workflow integrations. |
Building from source is intended for contributors and people who want to test the latest main branch. It requires Node.js 20 or newer, pnpm 10 or newer, Rust, and the Tauri prerequisites for your operating system.
git clone https://github.com/Hyperion-Workspace/Hyperion.git
cd Hyperion
pnpm install
pnpm tauri dev▋The application is a flat Next.js and Tauri project. Usepnpm check, pnpm typecheck, andpnpm build before contributing a change.
Open a new terminal. On Linux or macOS, also confirm that ~/.local/bin is included in PATH.
Ensure curl or wget andtar are installed. Git Bash, MSYS, and Cygwin also need unzip for Windows release archives.
Use the documented command exactly. The Windows launcher uses a process-scoped execution-policy bypass and requires PowerShell 5.1 or newer.
Download the EXE, MSI, DMG, AppImage, DEB, or RPM from the official download page.
Not when using a prebuilt release or the one-line installer. Node.js 20+, pnpm 10+, and Rust are only required when building Hyperion from source.
Not yet. The workspace and terminal grid are shipped. Agent lifecycle and task-board dispatch are in progress, while dependency-aware swarm orchestration is planned. This page separates available features from roadmap items deliberately.
Official binaries are attached to releases in the Hyperion-Workspace/Hyperion GitHub repository. The Hyperion download page selects the appropriate asset for your platform.
Yes. Press Q when the installer starts. Animations also disable automatically in CI, redirected output, dumb terminals, or when NO_COLOR is set.
Yes. Hyperion is available under the MIT License, and its desktop application source is published on GitHub.