🤖 feat: add first-class mux run CLI command
#881
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
ammar-agent
force-pushed
the
ephemeral-mux-cli-runtime
branch
11 times, most recently
from
888f233 to
ed5bf69
Compare
Replace the internal agentSessionCli.ts with a user-facing `mux run` command: - Add `mux run` subcommand with Commander.js for proper --help - Smart defaults: local runtime, medium thinking, auto-generated workspace ID - Human-friendly timeout parsing (5m, 300s, etc.) - Clean flag names (--json, --thinking, --dir) - Full documentation in docs/cli.md Update terminal-bench to use the new entry point: - benchmarks/terminal_bench/mux-run.sh now invokes src/cli/run.ts - Simpler invocation with fewer verbose flags Usage: mux run "Fix the tests" mux run --dir /project --runtime "ssh user@host" "Deploy" echo "Add logging" | mux run --json _Generated with `mux`_
Replace the janky hand-rolled duration regex with the well-tested parse-duration library. This supports more formats including: - Compound expressions: '1h30m', '1hr 20mins' - All common units: ms, s, m, h, d, w - Plain numbers as milliseconds _Generated with `mux`_
- Change default model from Sonnet to Opus 4.5 - Remove isDefault boolean from model definitions (no static guarantee) - Add DEFAULT_MODEL_KEY const that directly references a KnownModelKey - Update all hardcoded model strings to use the centralized DEFAULT_MODEL - Fix WORKSPACE_DEFAULTS to import from knownModels.ts The default model is now defined in one place: src/common/constants/knownModels.ts -> DEFAULT_MODEL_KEY = "OPUS" _Generated with `mux`_
- Replace manual argv parsing with proper Commander.js subcommands - Add --version flag with proper version info - Subcommands (run, server) now properly routed via executableFile - Default action launches desktop app when no subcommand given - Update docs to reflect --version flag instead of subcommand
- Add log levels: error, warn, info, debug (hierarchical) - Add log.warn() method and log.setLevel()/getLevel() for programmatic control - CLI defaults to 'error' level (quiet), Desktop defaults to 'info' - Add --verbose/-v flag to mux run to enable info-level logs - Add --log-level flag for explicit level control - Migrate all console.error/warn calls in src/node/ to log.* - Migrate ORPC error handler to use log.error - Fix circular dependency: log.ts no longer imports defaultConfig Environment variable MUX_LOG_LEVEL=error|warn|info|debug overrides defaults. MUX_DEBUG=1 enables debug level as before. _Generated with mux_
ammar-agent
force-pushed
the
ephemeral-mux-cli-runtime
branch
from
f7fc7d7 to
ce920e4
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Replace the internal
agentSessionCli.tswith a user-facingmux runcommand for running agent sessions from the command line, with unified logging across backend and CLI.Changes
New
mux runCommandKey improvements over the old CLI:
agentSessionCli.ts)mux run)--workspace-path X --workspace-id Y--dir--json-streaming--json--help--helpwith examplesdebug/--thinking-level-t, --thinking--timeout 5m(human-friendly)--verbosefor info)Unified Logging with Log Levels
error,warn,info,debug(hierarchical)error(quiet - only errors shown)info(current behavior preserved)MUX_LOG_LEVEL=warnorMUX_DEBUG=1Migrated ~30 files from raw
console.error/warn/logto unifiedlog.*calls.CLI Routing with Commander.js
Top-level routing uses Commander.js with lazy loading to avoid importing Electron/AI SDK until needed:
mux run- agent sessionsmux server- oRPC servermux api- API utilitiesmux desktop- launch GUI (auto-detected when running under Electron)Other Improvements
DEFAULT_MODELconstant)parse-durationlibrary for robust handling (1h30m,5min, etc.)Testing
src/cli/run.test.tsGenerated with
mux