The honest guide to installing Marshell, opening your first workspace, and understanding what is shipped today versus what is still being built.
Marshell 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.marshell.bond/install.sh | bashRuns the native Windows installer through PowerShell 5.1 or newer and registers Marshell for the current user.
powershell -c "irm https://www.marshell.bond/install.ps1 | iex"Downloads the Windows command launcher, which performs a preflight check and hands installation to PowerShell.
curl -fsSL https://www.marshell.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 Marshell 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 Marshell:
# Start Marshell 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 Marshell 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.
Marshell v1.0.0 ships release artifacts for Windows, macOS, and Linux through GitHub Releases.
Marshell 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 | Project workspace sidebar | Isolated project spaces, workspace-scoped state, and fast project switching. |
| Shipped | Multi-pane terminal grid | Split, resize, arrange, and clear real terminal panes attached to the active project. |
| Shipped | Cross-platform desktop artifacts | Signed desktop builds for Windows and macOS, alongside Linux AppImage, DEB, and RPM packages. |
| In Progress | Agent lifecycle & terminal spawning | Spawn background agents directly into project terminal panes with live output streams, stop, and restart controls. |
| In Progress | Task board with agent dispatch | Drag-and-drop task cards to assign work items directly to active agents. |
| Planned | Prompt Forge | Version, edit, and test reusable prompt templates across projects. |
| Planned | Dependency-aware swarm execution | Run multi-agent pipelines with explicit task dependencies, shared context, and trace visualization. |
| Planned | Plugin system | Extend Marshell 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 Marshell 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 Marshell 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. Marshell is available under the MIT License, and its desktop application source is published on GitHub.