START ON YOUR MAC
Choose your tools and run two lines in your Mac terminal.
The sign-in and first-run guide adapts to your selection.
INSTALL / MACOS
Use all three tools or begin with one.
The command updates with your selection.
macOS 13+ Apple Silicon / Intel Public preview
October 8, 2026 · Automatic model discovery · Execution reliability · Personal themes
Installs all six executables for the three tools.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool allScroll sideways to read both commands in full.
Paste both lines into your Mac terminal. No administrator password or GitHub login required.
gdmuxgdmuxdgdmuxctlgdmux-remotegidgdmAFTER INSTALL / FIRST RUN
Run the installation commands on your Mac,
then follow the guide for your selected tool.
You’ll need a Mac terminal. A modern terminal with 24-bit color support is recommended.
gdmuxPress Ctrl+B, then a to launch a task. Press Ctrl+B then v or s to split the view.
Ctrl+B then w opens all tasks; ? shows keyboard shortcuts.
The full installation includes gid. Follow the gid sign-in guide before running it inside gdmux.
You’ll need the official Codex or Claude CLI and an account with that service. Install the official CLI first.
gid auth statusRun one command below for the service you want to use.
gid login codex
# or
gid login claudeIn your project folder, run the command for your chosen service.
Codex:
gidClaude:
gid --provider claudeInstallation does not create an AI account or sign you in. Inside gdmux, press Ctrl+B then a to choose gid.
You’ll need a project to use the CLI directly. To request AI work, install Codex or Claude separately, along with the gdm skills.
gdm --help
gdm doctorAdd gdm skills if you want to request work from AI. For direct CLI use, see gdm --help for the available commands.
After installing the skills, start a new Codex or Claude session in your project.
In Codex:
$gdm-go Fix the login error and verify the resultIn Claude Code:
/gdm-go Fix the login error and verify the resultTo use the skills with Pi, install Pi separately, then launch gdm-pi. For everyday AI tasks, start with gdm-go.
The default install path is ~/.local/bin. After installation, open a new terminal and run your selected tool.
command not found: add the line below to your shell config (for default zsh, ~/.zshrc), then open a new terminal. PATH tells your terminal where to find executables.
export PATH="$HOME/.local/bin:$PATH"To choose a different path, add --prefix /absolute/path to the install command. For new gid tasks from iPhone, use the default path. The connection service currently looks for ~/.local/bin/gid.
The base installation adds executables and license notices only. It does not change shell startup files or AI agent settings.
Skills add gdm workflows for Codex, Claude, and Pi, the gdm-pi launcher, and a Codex task gate. This hook checks verification results when an AI task finishes.
Existing gdm skills are updated. Existing Codex hooks are preserved and backed up. If needed, the installer adds ~/.local/bin to your shell PATH. It does not copy other agents’ sign-in details. Start a new AI session after installation.
These links download archives without running the installer. Extract an archive and place the executables from bin/ in your chosen directory.
Release: preview-20261008.3. Release dates and builds may differ even when the application version is unchanged.
KEEP GOING
From updates to account connections,
find the details when you need them.
Select the tools you want to update and run the same installation command again. Tools you did not select stay installed as they are.
Running gdmux sessions keep using the existing background program. Finish your work, close all sessions, and start gdmux again to use the new version. The installer does not terminate running tasks.
Go to the install commandThe interface starts in Korean for a Korean system language, and English otherwise. Your manual choice is saved. This changes interface text only; terminal output, files, conversations, and AI response language are unchanged.
Full English support and an in-app language selector for iPhone are coming in the next update. The current App Store version has partial English support.
Open the globe icon at the top of this website to choose a language. Shared /en/ links always open in English. Switching languages preserves your selected tools and page location.
gdmux: press Ctrl+B, then p to open the command palette. Search for language and choose English, 한국어, or Auto. The change applies immediately and is saved to your config.
gid: enter /language en or /language ko in a conversation to save your preference. /language auto clears the fixed choice and follows your system language.
gdm: save your preference with gdm language en or gdm language ko. Use gdm language auto to return to automatic selection. For one launch only, use the commands below.
gdmux --language en
gid --language en
gdm --language en --helpgid’s default engine queries model lists through the official Codex and Claude CLIs. Open /model or press r to refresh. While the list stays open, it checks again every 15 minutes.
You don’t need to reinstall gid for every new model. The official CLI must expose the model, so update that CLI if the list is old. Actual availability still depends on your account and the service response.
If discovery fails, gid keeps the last successful list. Without a saved list, it shows default model aliases. New models do not replace your current selection or default. Choose a model, then use s or /model save to save your default.
Yes. gdmux and gid read settings from each user’s home folder. New installations start with Tokyo Night; existing choices are preserved. These examples use default config paths. Back up your config and merge only the settings you need.
Optional theme example: Black Glass. These files demonstrate personal color customization. The product screenshots use the default theme. Apply this skin only if you want it.
gid: ~/.config/gid/config.json, using ui.theme to choose a theme. This example shows only the relevant setting.
{
"ui": { "theme": "black-glass" }
}Download Black Glass JSON for gid ↓ · Save the downloaded file to ~/.config/gid/themes/black-glass.json. After saving it, select it in a conversation with /theme black-glass. A theme in the project’s .gid/settings.json takes priority over personal settings.
gdmux: ~/.config/gdmux/config.toml: edit [theme] and [theme.colors]. Download Black Glass TOML for gdmux ↓ and merge its two theme sections into your config. Do not duplicate sections or overwrite the whole file. Changes apply when you next open the gdmux view.
Translucent backgrounds: Black Glass follows your terminal background. Set a black background and opacity in Ghostty for a translucent surface, while reading panels stay dark and opaque. The example below is a Ghostty setting; a skin file does not change terminal settings.
background = 000000
background-opacity = 0.7
background-blur = trueYour terminal must support transparency. Native macOS full screen may appear opaque. Starting gdmux with --theme or GDMUX_THEME applies the named preset instead of custom file colors.
Delete only the executables for the tools you want to remove. These examples assume the default install path. This page displays the commands; it does not run them.
The four executables installed with gdmux:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remoteTo remove both gid and gdm:
rm ~/.local/bin/gid ~/.local/bin/gdmTo remove just one, keep only that executable’s path in the command. If you chose a different install directory, use its actual path.
Work records, conversations, account settings, and separately installed gdm skills remain. To remove skills, first disable the gdm hook in your agent settings, then remove each agent’s gdm-* skills. Keep other hooks intact.
AI features in gid require the official Codex or Claude CLI and sign-in to that service. Use gid auth status to check your status. For your chosen service, run gid login codex or gid login claude.
AI service access is not included. If sign-in fails, check authentication in the corresponding official CLI as well.
gid first-run guideThis public preview supports Apple Silicon and Intel Macs running macOS 13 or later. Public executables are Developer ID signed and Apple notarized. You do not need Rust, Bun, or a GitHub login to install them.
The source repository is private. Public Windows and Linux installers are not available yet.
On iOS 17 or later, download gdmux from the App Store for free. Remote work requires a Mac that stays on and online, plus the connection service.
Run the command below on your Mac and follow the account and Mac pairing steps. Use the same account in the iPhone app. Inside gdmux, press Ctrl+B then m to open connection settings.
gdmux --remoteTo create a new gid task from your iPhone, install gid separately or select all tools. Install it at the default path: the Mac currently uses ~/.local/bin/gid.
START ON YOUR MAC
Choose your tools and run two lines in your Mac terminal.
The sign-in and first-run guide adapts to your selection.
INSTALL / MACOS
Use all three tools or begin with one.
The command updates with your selection.
macOS 13+ Apple Silicon / Intel Public preview
October 8, 2026 · Automatic model discovery · Execution reliability · Personal themes
Installs gdmux and three supporting executables for sessions and remote access.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdmuxScroll sideways to read both commands in full.
Paste both lines into your Mac terminal. No administrator password or GitHub login required.
gdmuxgdmuxdgdmuxctlgdmux-remoteYou can include gdm skills when you choose Install all or gdm.
AFTER INSTALL / FIRST RUN
Run the installation commands on your Mac,
then follow the guide for your selected tool.
You’ll need a Mac terminal. A modern terminal with 24-bit color support is recommended.
gdmuxPress Ctrl+B, then a to launch a task. Press Ctrl+B then v or s to split the view.
Ctrl+B then w opens all tasks; ? shows keyboard shortcuts.
Ctrl+Q leaves the view. Tasks keep running while the background session manager is active.
To launch gid tasks in gdmux, install gid too. See the FAQ below to prepare your iPhone connection.
The default install path is ~/.local/bin. After installation, open a new terminal and run your selected tool.
command not found: add the line below to your shell config (for default zsh, ~/.zshrc), then open a new terminal. PATH tells your terminal where to find executables.
export PATH="$HOME/.local/bin:$PATH"To choose a different path, add --prefix /absolute/path to the install command. For new gid tasks from iPhone, use the default path. The connection service currently looks for ~/.local/bin/gid.
The base installation adds executables and license notices only. It does not change shell startup files or AI agent settings.
Skills add gdm workflows for Codex, Claude, and Pi, the gdm-pi launcher, and a Codex task gate. This hook checks verification results when an AI task finishes.
Existing gdm skills are updated. Existing Codex hooks are preserved and backed up. If needed, the installer adds ~/.local/bin to your shell PATH. It does not copy other agents’ sign-in details. Start a new AI session after installation.
These links download archives without running the installer. Extract an archive and place the executables from bin/ in your chosen directory.
Release: preview-20261008.3. Release dates and builds may differ even when the application version is unchanged.
KEEP GOING
From updates to account connections,
find the details when you need them.
Select the tools you want to update and run the same installation command again. Tools you did not select stay installed as they are.
Running gdmux sessions keep using the existing background program. Finish your work, close all sessions, and start gdmux again to use the new version. The installer does not terminate running tasks.
Go to the install commandThe interface starts in Korean for a Korean system language, and English otherwise. Your manual choice is saved. This changes interface text only; terminal output, files, conversations, and AI response language are unchanged.
Full English support and an in-app language selector for iPhone are coming in the next update. The current App Store version has partial English support.
Open the globe icon at the top of this website to choose a language. Shared /en/ links always open in English. Switching languages preserves your selected tools and page location.
gdmux: press Ctrl+B, then p to open the command palette. Search for language and choose English, 한국어, or Auto. The change applies immediately and is saved to your config.
gid: enter /language en or /language ko in a conversation to save your preference. /language auto clears the fixed choice and follows your system language.
gdm: save your preference with gdm language en or gdm language ko. Use gdm language auto to return to automatic selection. For one launch only, use the commands below.
gdmux --language en
gid --language en
gdm --language en --helpgid’s default engine queries model lists through the official Codex and Claude CLIs. Open /model or press r to refresh. While the list stays open, it checks again every 15 minutes.
You don’t need to reinstall gid for every new model. The official CLI must expose the model, so update that CLI if the list is old. Actual availability still depends on your account and the service response.
If discovery fails, gid keeps the last successful list. Without a saved list, it shows default model aliases. New models do not replace your current selection or default. Choose a model, then use s or /model save to save your default.
Yes. gdmux and gid read settings from each user’s home folder. New installations start with Tokyo Night; existing choices are preserved. These examples use default config paths. Back up your config and merge only the settings you need.
Optional theme example: Black Glass. These files demonstrate personal color customization. The product screenshots use the default theme. Apply this skin only if you want it.
gid: ~/.config/gid/config.json, using ui.theme to choose a theme. This example shows only the relevant setting.
{
"ui": { "theme": "black-glass" }
}Download Black Glass JSON for gid ↓ · Save the downloaded file to ~/.config/gid/themes/black-glass.json. After saving it, select it in a conversation with /theme black-glass. A theme in the project’s .gid/settings.json takes priority over personal settings.
gdmux: ~/.config/gdmux/config.toml: edit [theme] and [theme.colors]. Download Black Glass TOML for gdmux ↓ and merge its two theme sections into your config. Do not duplicate sections or overwrite the whole file. Changes apply when you next open the gdmux view.
Translucent backgrounds: Black Glass follows your terminal background. Set a black background and opacity in Ghostty for a translucent surface, while reading panels stay dark and opaque. The example below is a Ghostty setting; a skin file does not change terminal settings.
background = 000000
background-opacity = 0.7
background-blur = trueYour terminal must support transparency. Native macOS full screen may appear opaque. Starting gdmux with --theme or GDMUX_THEME applies the named preset instead of custom file colors.
Delete only the executables for the tools you want to remove. These examples assume the default install path. This page displays the commands; it does not run them.
The four executables installed with gdmux:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remoteTo remove both gid and gdm:
rm ~/.local/bin/gid ~/.local/bin/gdmTo remove just one, keep only that executable’s path in the command. If you chose a different install directory, use its actual path.
Work records, conversations, account settings, and separately installed gdm skills remain. To remove skills, first disable the gdm hook in your agent settings, then remove each agent’s gdm-* skills. Keep other hooks intact.
AI features in gid require the official Codex or Claude CLI and sign-in to that service. Use gid auth status to check your status. For your chosen service, run gid login codex or gid login claude.
AI service access is not included. If sign-in fails, check authentication in the corresponding official CLI as well.
gid first-run guideThis public preview supports Apple Silicon and Intel Macs running macOS 13 or later. Public executables are Developer ID signed and Apple notarized. You do not need Rust, Bun, or a GitHub login to install them.
The source repository is private. Public Windows and Linux installers are not available yet.
On iOS 17 or later, download gdmux from the App Store for free. Remote work requires a Mac that stays on and online, plus the connection service.
Run the command below on your Mac and follow the account and Mac pairing steps. Use the same account in the iPhone app. Inside gdmux, press Ctrl+B then m to open connection settings.
gdmux --remoteTo create a new gid task from your iPhone, install gid separately or select all tools. Install it at the default path: the Mac currently uses ~/.local/bin/gid.
START ON YOUR MAC
Choose your tools and run two lines in your Mac terminal.
The sign-in and first-run guide adapts to your selection.
INSTALL / MACOS
Use all three tools or begin with one.
The command updates with your selection.
macOS 13+ Apple Silicon / Intel Public preview
October 8, 2026 · Automatic model discovery · Execution reliability · Personal themes
Installs the gid executable for coding conversations.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gidScroll sideways to read both commands in full.
Paste both lines into your Mac terminal. No administrator password or GitHub login required.
gidYou can include gdm skills when you choose Install all or gdm.
AFTER INSTALL / FIRST RUN
Run the installation commands on your Mac,
then follow the guide for your selected tool.
You’ll need the official Codex or Claude CLI and an account with that service. Install the official CLI first.
gid auth statusRun one command below for the service you want to use.
gid login codex
# or
gid login claudemy-project should be your actual project folder. If you’re already there, just run gid.
gid --cwd ~/projects/my-projectFor Claude:
gid --provider claude --cwd ~/projects/my-projectInstallation does not create an AI account or sign you in. Inside gdmux, press Ctrl+B then a to choose gid.
The default install path is ~/.local/bin. After installation, open a new terminal and run your selected tool.
command not found: add the line below to your shell config (for default zsh, ~/.zshrc), then open a new terminal. PATH tells your terminal where to find executables.
export PATH="$HOME/.local/bin:$PATH"To choose a different path, add --prefix /absolute/path to the install command. For new gid tasks from iPhone, use the default path. The connection service currently looks for ~/.local/bin/gid.
The base installation adds executables and license notices only. It does not change shell startup files or AI agent settings.
Skills add gdm workflows for Codex, Claude, and Pi, the gdm-pi launcher, and a Codex task gate. This hook checks verification results when an AI task finishes.
Existing gdm skills are updated. Existing Codex hooks are preserved and backed up. If needed, the installer adds ~/.local/bin to your shell PATH. It does not copy other agents’ sign-in details. Start a new AI session after installation.
These links download archives without running the installer. Extract an archive and place the executables from bin/ in your chosen directory.
Release: preview-20261008.3. Release dates and builds may differ even when the application version is unchanged.
KEEP GOING
From updates to account connections,
find the details when you need them.
Select the tools you want to update and run the same installation command again. Tools you did not select stay installed as they are.
Running gdmux sessions keep using the existing background program. Finish your work, close all sessions, and start gdmux again to use the new version. The installer does not terminate running tasks.
Go to the install commandThe interface starts in Korean for a Korean system language, and English otherwise. Your manual choice is saved. This changes interface text only; terminal output, files, conversations, and AI response language are unchanged.
Full English support and an in-app language selector for iPhone are coming in the next update. The current App Store version has partial English support.
Open the globe icon at the top of this website to choose a language. Shared /en/ links always open in English. Switching languages preserves your selected tools and page location.
gdmux: press Ctrl+B, then p to open the command palette. Search for language and choose English, 한국어, or Auto. The change applies immediately and is saved to your config.
gid: enter /language en or /language ko in a conversation to save your preference. /language auto clears the fixed choice and follows your system language.
gdm: save your preference with gdm language en or gdm language ko. Use gdm language auto to return to automatic selection. For one launch only, use the commands below.
gdmux --language en
gid --language en
gdm --language en --helpgid’s default engine queries model lists through the official Codex and Claude CLIs. Open /model or press r to refresh. While the list stays open, it checks again every 15 minutes.
You don’t need to reinstall gid for every new model. The official CLI must expose the model, so update that CLI if the list is old. Actual availability still depends on your account and the service response.
If discovery fails, gid keeps the last successful list. Without a saved list, it shows default model aliases. New models do not replace your current selection or default. Choose a model, then use s or /model save to save your default.
Yes. gdmux and gid read settings from each user’s home folder. New installations start with Tokyo Night; existing choices are preserved. These examples use default config paths. Back up your config and merge only the settings you need.
Optional theme example: Black Glass. These files demonstrate personal color customization. The product screenshots use the default theme. Apply this skin only if you want it.
gid: ~/.config/gid/config.json, using ui.theme to choose a theme. This example shows only the relevant setting.
{
"ui": { "theme": "black-glass" }
}Download Black Glass JSON for gid ↓ · Save the downloaded file to ~/.config/gid/themes/black-glass.json. After saving it, select it in a conversation with /theme black-glass. A theme in the project’s .gid/settings.json takes priority over personal settings.
gdmux: ~/.config/gdmux/config.toml: edit [theme] and [theme.colors]. Download Black Glass TOML for gdmux ↓ and merge its two theme sections into your config. Do not duplicate sections or overwrite the whole file. Changes apply when you next open the gdmux view.
Translucent backgrounds: Black Glass follows your terminal background. Set a black background and opacity in Ghostty for a translucent surface, while reading panels stay dark and opaque. The example below is a Ghostty setting; a skin file does not change terminal settings.
background = 000000
background-opacity = 0.7
background-blur = trueYour terminal must support transparency. Native macOS full screen may appear opaque. Starting gdmux with --theme or GDMUX_THEME applies the named preset instead of custom file colors.
Delete only the executables for the tools you want to remove. These examples assume the default install path. This page displays the commands; it does not run them.
The four executables installed with gdmux:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remoteTo remove both gid and gdm:
rm ~/.local/bin/gid ~/.local/bin/gdmTo remove just one, keep only that executable’s path in the command. If you chose a different install directory, use its actual path.
Work records, conversations, account settings, and separately installed gdm skills remain. To remove skills, first disable the gdm hook in your agent settings, then remove each agent’s gdm-* skills. Keep other hooks intact.
AI features in gid require the official Codex or Claude CLI and sign-in to that service. Use gid auth status to check your status. For your chosen service, run gid login codex or gid login claude.
AI service access is not included. If sign-in fails, check authentication in the corresponding official CLI as well.
gid first-run guideThis public preview supports Apple Silicon and Intel Macs running macOS 13 or later. Public executables are Developer ID signed and Apple notarized. You do not need Rust, Bun, or a GitHub login to install them.
The source repository is private. Public Windows and Linux installers are not available yet.
On iOS 17 or later, download gdmux from the App Store for free. Remote work requires a Mac that stays on and online, plus the connection service.
Run the command below on your Mac and follow the account and Mac pairing steps. Use the same account in the iPhone app. Inside gdmux, press Ctrl+B then m to open connection settings.
gdmux --remoteTo create a new gid task from your iPhone, install gid separately or select all tools. Install it at the default path: the Mac currently uses ~/.local/bin/gid.
START ON YOUR MAC
Choose your tools and run two lines in your Mac terminal.
The sign-in and first-run guide adapts to your selection.
INSTALL / MACOS
Use all three tools or begin with one.
The command updates with your selection.
macOS 13+ Apple Silicon / Intel Public preview
October 8, 2026 · Automatic model discovery · Execution reliability · Personal themes
Installs the gdm executable for work verification.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdmScroll sideways to read both commands in full.
Paste both lines into your Mac terminal. No administrator password or GitHub login required.
gdmAFTER INSTALL / FIRST RUN
Run the installation commands on your Mac,
then follow the guide for your selected tool.
You’ll need a project to use the CLI directly. To request AI work, install Codex or Claude separately, along with the gdm skills.
gdm --help
gdm doctorAdd gdm skills if you want to request work from AI. For direct CLI use, see gdm --help for the available commands.
After installing the skills, start a new Codex or Claude session in your project.
In Codex:
$gdm-go Fix the login error and verify the resultIn Claude Code:
/gdm-go Fix the login error and verify the resultTo use the skills with Pi, install Pi separately, then launch gdm-pi. For everyday AI tasks, start with gdm-go.
The default install path is ~/.local/bin. After installation, open a new terminal and run your selected tool.
command not found: add the line below to your shell config (for default zsh, ~/.zshrc), then open a new terminal. PATH tells your terminal where to find executables.
export PATH="$HOME/.local/bin:$PATH"To choose a different path, add --prefix /absolute/path to the install command. For new gid tasks from iPhone, use the default path. The connection service currently looks for ~/.local/bin/gid.
The base installation adds executables and license notices only. It does not change shell startup files or AI agent settings.
Skills add gdm workflows for Codex, Claude, and Pi, the gdm-pi launcher, and a Codex task gate. This hook checks verification results when an AI task finishes.
Existing gdm skills are updated. Existing Codex hooks are preserved and backed up. If needed, the installer adds ~/.local/bin to your shell PATH. It does not copy other agents’ sign-in details. Start a new AI session after installation.
These links download archives without running the installer. Extract an archive and place the executables from bin/ in your chosen directory.
Release: preview-20261008.3. Release dates and builds may differ even when the application version is unchanged.
KEEP GOING
From updates to account connections,
find the details when you need them.
Select the tools you want to update and run the same installation command again. Tools you did not select stay installed as they are.
Running gdmux sessions keep using the existing background program. Finish your work, close all sessions, and start gdmux again to use the new version. The installer does not terminate running tasks.
Go to the install commandThe interface starts in Korean for a Korean system language, and English otherwise. Your manual choice is saved. This changes interface text only; terminal output, files, conversations, and AI response language are unchanged.
Full English support and an in-app language selector for iPhone are coming in the next update. The current App Store version has partial English support.
Open the globe icon at the top of this website to choose a language. Shared /en/ links always open in English. Switching languages preserves your selected tools and page location.
gdmux: press Ctrl+B, then p to open the command palette. Search for language and choose English, 한국어, or Auto. The change applies immediately and is saved to your config.
gid: enter /language en or /language ko in a conversation to save your preference. /language auto clears the fixed choice and follows your system language.
gdm: save your preference with gdm language en or gdm language ko. Use gdm language auto to return to automatic selection. For one launch only, use the commands below.
gdmux --language en
gid --language en
gdm --language en --helpgid’s default engine queries model lists through the official Codex and Claude CLIs. Open /model or press r to refresh. While the list stays open, it checks again every 15 minutes.
You don’t need to reinstall gid for every new model. The official CLI must expose the model, so update that CLI if the list is old. Actual availability still depends on your account and the service response.
If discovery fails, gid keeps the last successful list. Without a saved list, it shows default model aliases. New models do not replace your current selection or default. Choose a model, then use s or /model save to save your default.
Yes. gdmux and gid read settings from each user’s home folder. New installations start with Tokyo Night; existing choices are preserved. These examples use default config paths. Back up your config and merge only the settings you need.
Optional theme example: Black Glass. These files demonstrate personal color customization. The product screenshots use the default theme. Apply this skin only if you want it.
gid: ~/.config/gid/config.json, using ui.theme to choose a theme. This example shows only the relevant setting.
{
"ui": { "theme": "black-glass" }
}Download Black Glass JSON for gid ↓ · Save the downloaded file to ~/.config/gid/themes/black-glass.json. After saving it, select it in a conversation with /theme black-glass. A theme in the project’s .gid/settings.json takes priority over personal settings.
gdmux: ~/.config/gdmux/config.toml: edit [theme] and [theme.colors]. Download Black Glass TOML for gdmux ↓ and merge its two theme sections into your config. Do not duplicate sections or overwrite the whole file. Changes apply when you next open the gdmux view.
Translucent backgrounds: Black Glass follows your terminal background. Set a black background and opacity in Ghostty for a translucent surface, while reading panels stay dark and opaque. The example below is a Ghostty setting; a skin file does not change terminal settings.
background = 000000
background-opacity = 0.7
background-blur = trueYour terminal must support transparency. Native macOS full screen may appear opaque. Starting gdmux with --theme or GDMUX_THEME applies the named preset instead of custom file colors.
Delete only the executables for the tools you want to remove. These examples assume the default install path. This page displays the commands; it does not run them.
The four executables installed with gdmux:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remoteTo remove both gid and gdm:
rm ~/.local/bin/gid ~/.local/bin/gdmTo remove just one, keep only that executable’s path in the command. If you chose a different install directory, use its actual path.
Work records, conversations, account settings, and separately installed gdm skills remain. To remove skills, first disable the gdm hook in your agent settings, then remove each agent’s gdm-* skills. Keep other hooks intact.
AI features in gid require the official Codex or Claude CLI and sign-in to that service. Use gid auth status to check your status. For your chosen service, run gid login codex or gid login claude.
AI service access is not included. If sign-in fails, check authentication in the corresponding official CLI as well.
gid first-run guideThis public preview supports Apple Silicon and Intel Macs running macOS 13 or later. Public executables are Developer ID signed and Apple notarized. You do not need Rust, Bun, or a GitHub login to install them.
The source repository is private. Public Windows and Linux installers are not available yet.
On iOS 17 or later, download gdmux from the App Store for free. Remote work requires a Mac that stays on and online, plus the connection service.
Run the command below on your Mac and follow the account and Mac pairing steps. Use the same account in the iPhone app. Inside gdmux, press Ctrl+B then m to open connection settings.
gdmux --remoteTo create a new gid task from your iPhone, install gid separately or select all tools. Install it at the default path: the Mac currently uses ~/.local/bin/gid.
START ON YOUR MAC
Choose your tools and run two lines in your Mac terminal.
The sign-in and first-run guide adapts to your selection.
INSTALL / MACOS
Use all three tools or begin with one.
The command updates with your selection.
macOS 13+ Apple Silicon / Intel Public preview
October 8, 2026 · Automatic model discovery · Execution reliability · Personal themes
Installs all six executables for the three tools.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool all --with-skillsScroll sideways to read both commands in full.
Paste both lines into your Mac terminal. No administrator password or GitHub login required.
gdmuxgdmuxdgdmuxctlgdmux-remotegidgdmAFTER INSTALL / FIRST RUN
Run the installation commands on your Mac,
then follow the guide for your selected tool.
You’ll need a Mac terminal. A modern terminal with 24-bit color support is recommended.
gdmuxPress Ctrl+B, then a to launch a task. Press Ctrl+B then v or s to split the view.
Ctrl+B then w opens all tasks; ? shows keyboard shortcuts.
The full installation includes gid. Follow the gid sign-in guide before running it inside gdmux.
You’ll need the official Codex or Claude CLI and an account with that service. Install the official CLI first.
gid auth statusRun one command below for the service you want to use.
gid login codex
# or
gid login claudeIn your project folder, run the command for your chosen service.
Codex:
gidClaude:
gid --provider claudeInstallation does not create an AI account or sign you in. Inside gdmux, press Ctrl+B then a to choose gid.
You’ll need a project to use the CLI directly. To request AI work, install Codex or Claude separately, along with the gdm skills.
gdm --help
gdm doctorThe install command above includes --with-skills. Run it, then start a new Codex or Claude session in your project.
In Codex:
$gdm-go Fix the login error and verify the resultIn Claude Code:
/gdm-go Fix the login error and verify the resultTo use the skills with Pi, install Pi separately, then launch gdm-pi. For everyday AI tasks, start with gdm-go.
The default install path is ~/.local/bin. After installation, open a new terminal and run your selected tool.
command not found: add the line below to your shell config (for default zsh, ~/.zshrc), then open a new terminal. PATH tells your terminal where to find executables.
export PATH="$HOME/.local/bin:$PATH"To choose a different path, add --prefix /absolute/path to the install command. For new gid tasks from iPhone, use the default path. The connection service currently looks for ~/.local/bin/gid.
The base installation adds executables and license notices only. It does not change shell startup files or AI agent settings.
Skills add gdm workflows for Codex, Claude, and Pi, the gdm-pi launcher, and a Codex task gate. This hook checks verification results when an AI task finishes.
Existing gdm skills are updated. Existing Codex hooks are preserved and backed up. If needed, the installer adds ~/.local/bin to your shell PATH. It does not copy other agents’ sign-in details. Start a new AI session after installation.
These links download archives without running the installer. Extract an archive and place the executables from bin/ in your chosen directory.
Release: preview-20261008.3. Release dates and builds may differ even when the application version is unchanged.
KEEP GOING
From updates to account connections,
find the details when you need them.
Select the tools you want to update and run the same installation command again. Tools you did not select stay installed as they are.
Running gdmux sessions keep using the existing background program. Finish your work, close all sessions, and start gdmux again to use the new version. The installer does not terminate running tasks.
Go to the install commandThe interface starts in Korean for a Korean system language, and English otherwise. Your manual choice is saved. This changes interface text only; terminal output, files, conversations, and AI response language are unchanged.
Full English support and an in-app language selector for iPhone are coming in the next update. The current App Store version has partial English support.
Open the globe icon at the top of this website to choose a language. Shared /en/ links always open in English. Switching languages preserves your selected tools and page location.
gdmux: press Ctrl+B, then p to open the command palette. Search for language and choose English, 한국어, or Auto. The change applies immediately and is saved to your config.
gid: enter /language en or /language ko in a conversation to save your preference. /language auto clears the fixed choice and follows your system language.
gdm: save your preference with gdm language en or gdm language ko. Use gdm language auto to return to automatic selection. For one launch only, use the commands below.
gdmux --language en
gid --language en
gdm --language en --helpgid’s default engine queries model lists through the official Codex and Claude CLIs. Open /model or press r to refresh. While the list stays open, it checks again every 15 minutes.
You don’t need to reinstall gid for every new model. The official CLI must expose the model, so update that CLI if the list is old. Actual availability still depends on your account and the service response.
If discovery fails, gid keeps the last successful list. Without a saved list, it shows default model aliases. New models do not replace your current selection or default. Choose a model, then use s or /model save to save your default.
Yes. gdmux and gid read settings from each user’s home folder. New installations start with Tokyo Night; existing choices are preserved. These examples use default config paths. Back up your config and merge only the settings you need.
Optional theme example: Black Glass. These files demonstrate personal color customization. The product screenshots use the default theme. Apply this skin only if you want it.
gid: ~/.config/gid/config.json, using ui.theme to choose a theme. This example shows only the relevant setting.
{
"ui": { "theme": "black-glass" }
}Download Black Glass JSON for gid ↓ · Save the downloaded file to ~/.config/gid/themes/black-glass.json. After saving it, select it in a conversation with /theme black-glass. A theme in the project’s .gid/settings.json takes priority over personal settings.
gdmux: ~/.config/gdmux/config.toml: edit [theme] and [theme.colors]. Download Black Glass TOML for gdmux ↓ and merge its two theme sections into your config. Do not duplicate sections or overwrite the whole file. Changes apply when you next open the gdmux view.
Translucent backgrounds: Black Glass follows your terminal background. Set a black background and opacity in Ghostty for a translucent surface, while reading panels stay dark and opaque. The example below is a Ghostty setting; a skin file does not change terminal settings.
background = 000000
background-opacity = 0.7
background-blur = trueYour terminal must support transparency. Native macOS full screen may appear opaque. Starting gdmux with --theme or GDMUX_THEME applies the named preset instead of custom file colors.
Delete only the executables for the tools you want to remove. These examples assume the default install path. This page displays the commands; it does not run them.
The four executables installed with gdmux:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remoteTo remove both gid and gdm:
rm ~/.local/bin/gid ~/.local/bin/gdmTo remove just one, keep only that executable’s path in the command. If you chose a different install directory, use its actual path.
Work records, conversations, account settings, and separately installed gdm skills remain. To remove skills, first disable the gdm hook in your agent settings, then remove each agent’s gdm-* skills. Keep other hooks intact.
AI features in gid require the official Codex or Claude CLI and sign-in to that service. Use gid auth status to check your status. For your chosen service, run gid login codex or gid login claude.
AI service access is not included. If sign-in fails, check authentication in the corresponding official CLI as well.
gid first-run guideThis public preview supports Apple Silicon and Intel Macs running macOS 13 or later. Public executables are Developer ID signed and Apple notarized. You do not need Rust, Bun, or a GitHub login to install them.
The source repository is private. Public Windows and Linux installers are not available yet.
On iOS 17 or later, download gdmux from the App Store for free. Remote work requires a Mac that stays on and online, plus the connection service.
Run the command below on your Mac and follow the account and Mac pairing steps. Use the same account in the iPhone app. Inside gdmux, press Ctrl+B then m to open connection settings.
gdmux --remoteTo create a new gid task from your iPhone, install gid separately or select all tools. Install it at the default path: the Mac currently uses ~/.local/bin/gid.
START ON YOUR MAC
Choose your tools and run two lines in your Mac terminal.
The sign-in and first-run guide adapts to your selection.
INSTALL / MACOS
Use all three tools or begin with one.
The command updates with your selection.
macOS 13+ Apple Silicon / Intel Public preview
October 8, 2026 · Automatic model discovery · Execution reliability · Personal themes
Installs the gdm executable for work verification.
curl -fL https://gdmux.pages.dev/install.sh -o /tmp/gdm-tools-install.sh
zsh /tmp/gdm-tools-install.sh --tool gdm --with-skillsScroll sideways to read both commands in full.
Paste both lines into your Mac terminal. No administrator password or GitHub login required.
gdmAFTER INSTALL / FIRST RUN
Run the installation commands on your Mac,
then follow the guide for your selected tool.
You’ll need a project to use the CLI directly. To request AI work, install Codex or Claude separately, along with the gdm skills.
gdm --help
gdm doctorThe install command above includes --with-skills. Run it, then start a new Codex or Claude session in your project.
In Codex:
$gdm-go Fix the login error and verify the resultIn Claude Code:
/gdm-go Fix the login error and verify the resultTo use the skills with Pi, install Pi separately, then launch gdm-pi. For everyday AI tasks, start with gdm-go.
The default install path is ~/.local/bin. After installation, open a new terminal and run your selected tool.
command not found: add the line below to your shell config (for default zsh, ~/.zshrc), then open a new terminal. PATH tells your terminal where to find executables.
export PATH="$HOME/.local/bin:$PATH"To choose a different path, add --prefix /absolute/path to the install command. For new gid tasks from iPhone, use the default path. The connection service currently looks for ~/.local/bin/gid.
The base installation adds executables and license notices only. It does not change shell startup files or AI agent settings.
Skills add gdm workflows for Codex, Claude, and Pi, the gdm-pi launcher, and a Codex task gate. This hook checks verification results when an AI task finishes.
Existing gdm skills are updated. Existing Codex hooks are preserved and backed up. If needed, the installer adds ~/.local/bin to your shell PATH. It does not copy other agents’ sign-in details. Start a new AI session after installation.
These links download archives without running the installer. Extract an archive and place the executables from bin/ in your chosen directory.
Release: preview-20261008.3. Release dates and builds may differ even when the application version is unchanged.
KEEP GOING
From updates to account connections,
find the details when you need them.
Select the tools you want to update and run the same installation command again. Tools you did not select stay installed as they are.
Running gdmux sessions keep using the existing background program. Finish your work, close all sessions, and start gdmux again to use the new version. The installer does not terminate running tasks.
Go to the install commandThe interface starts in Korean for a Korean system language, and English otherwise. Your manual choice is saved. This changes interface text only; terminal output, files, conversations, and AI response language are unchanged.
Full English support and an in-app language selector for iPhone are coming in the next update. The current App Store version has partial English support.
Open the globe icon at the top of this website to choose a language. Shared /en/ links always open in English. Switching languages preserves your selected tools and page location.
gdmux: press Ctrl+B, then p to open the command palette. Search for language and choose English, 한국어, or Auto. The change applies immediately and is saved to your config.
gid: enter /language en or /language ko in a conversation to save your preference. /language auto clears the fixed choice and follows your system language.
gdm: save your preference with gdm language en or gdm language ko. Use gdm language auto to return to automatic selection. For one launch only, use the commands below.
gdmux --language en
gid --language en
gdm --language en --helpgid’s default engine queries model lists through the official Codex and Claude CLIs. Open /model or press r to refresh. While the list stays open, it checks again every 15 minutes.
You don’t need to reinstall gid for every new model. The official CLI must expose the model, so update that CLI if the list is old. Actual availability still depends on your account and the service response.
If discovery fails, gid keeps the last successful list. Without a saved list, it shows default model aliases. New models do not replace your current selection or default. Choose a model, then use s or /model save to save your default.
Yes. gdmux and gid read settings from each user’s home folder. New installations start with Tokyo Night; existing choices are preserved. These examples use default config paths. Back up your config and merge only the settings you need.
Optional theme example: Black Glass. These files demonstrate personal color customization. The product screenshots use the default theme. Apply this skin only if you want it.
gid: ~/.config/gid/config.json, using ui.theme to choose a theme. This example shows only the relevant setting.
{
"ui": { "theme": "black-glass" }
}Download Black Glass JSON for gid ↓ · Save the downloaded file to ~/.config/gid/themes/black-glass.json. After saving it, select it in a conversation with /theme black-glass. A theme in the project’s .gid/settings.json takes priority over personal settings.
gdmux: ~/.config/gdmux/config.toml: edit [theme] and [theme.colors]. Download Black Glass TOML for gdmux ↓ and merge its two theme sections into your config. Do not duplicate sections or overwrite the whole file. Changes apply when you next open the gdmux view.
Translucent backgrounds: Black Glass follows your terminal background. Set a black background and opacity in Ghostty for a translucent surface, while reading panels stay dark and opaque. The example below is a Ghostty setting; a skin file does not change terminal settings.
background = 000000
background-opacity = 0.7
background-blur = trueYour terminal must support transparency. Native macOS full screen may appear opaque. Starting gdmux with --theme or GDMUX_THEME applies the named preset instead of custom file colors.
Delete only the executables for the tools you want to remove. These examples assume the default install path. This page displays the commands; it does not run them.
The four executables installed with gdmux:
rm ~/.local/bin/gdmux ~/.local/bin/gdmuxd ~/.local/bin/gdmuxctl ~/.local/bin/gdmux-remoteTo remove both gid and gdm:
rm ~/.local/bin/gid ~/.local/bin/gdmTo remove just one, keep only that executable’s path in the command. If you chose a different install directory, use its actual path.
Work records, conversations, account settings, and separately installed gdm skills remain. To remove skills, first disable the gdm hook in your agent settings, then remove each agent’s gdm-* skills. Keep other hooks intact.
AI features in gid require the official Codex or Claude CLI and sign-in to that service. Use gid auth status to check your status. For your chosen service, run gid login codex or gid login claude.
AI service access is not included. If sign-in fails, check authentication in the corresponding official CLI as well.
gid first-run guideThis public preview supports Apple Silicon and Intel Macs running macOS 13 or later. Public executables are Developer ID signed and Apple notarized. You do not need Rust, Bun, or a GitHub login to install them.
The source repository is private. Public Windows and Linux installers are not available yet.
On iOS 17 or later, download gdmux from the App Store for free. Remote work requires a Mac that stays on and online, plus the connection service.
Run the command below on your Mac and follow the account and Mac pairing steps. Use the same account in the iPhone app. Inside gdmux, press Ctrl+B then m to open connection settings.
gdmux --remoteTo create a new gid task from your iPhone, install gid separately or select all tools. Install it at the default path: the Mac currently uses ~/.local/bin/gid.