Skip to content

🤖 feat: add custom executable slash commands (.mux/commands/) #1523

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
ammar-agent wants to merge 8 commits into
base: main
Choose a base branch
from
Open

🤖 feat: add custom executable slash commands (.mux/commands/) #1523

ammar-agent wants to merge 8 commits into from

Conversation

@ammar-agent
Copy link
Collaborator

@ammar-agent ammar-agent commented Jan 9, 2026

Summary

Adds support for custom slash commands that run executables in the workspace.

Features

  • Discovery: Executables at .mux/commands/<name> are discovered and appear in slash command autocomplete
  • Execution: /<name> [args...] runs the command with:
    • First line tokens become argv
    • Lines after the first become stdin
    • Stdout streams in real-time via init events
    • Stdout becomes the user message on success
  • Environment: Commands receive MUX_* env vars (project path, runtime, workspace name, workspace path)

Example

#!/bin/bash
# .mux/commands/refinement
echo "Refine this:"
cat

Then use with: /refinement\n<text to refine>

Implementation

  • Backend: SlashCommandService for discovery and execution with streaming
  • Frontend: Parser extended with rawInput for unknown commands
  • Frontend: ChatInput wired to execute custom commands and show autocomplete
  • Docs: New page at docs/hooks/slash-commands.mdx

Testing

  • All slash command parser and suggestion tests pass
  • Static checks pass
  • New functionality is exercised through manual testing

Generated with mux • Model: anthropic:claude-opus-4-5 • Thinking: high • Cost: $11.85

chatgpt-codex-connector[bot]
chatgpt-codex-connector bot reviewed Jan 9, 2026
View reviewed changes
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c8152aa515

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@ammar-agent ammar-agent added the docs Improvements or additions to documentation label Jan 9, 2026
@ammar-agent
Copy link
Collaborator Author

ammar-agent commented Jan 9, 2026

@codex review

Addressed the P1 and P2 review comments:

  • P1: Now quoting command path before exec to handle spaces in workspace paths
  • P2: Removed .trim() from stdin processing to preserve whitespace

Also added:

  • Exit code 2 handling (show output but don't send to model)
  • Progressive examples in docs (static msg, args, stdin)
  • UI integration tests covering suggestions, execution, exit codes
  • Unit tests for custom command suggestions

chatgpt-codex-connector[bot]
chatgpt-codex-connector bot reviewed Jan 9, 2026
View reviewed changes
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ccbeaea806

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@ammar-agent
Copy link
Collaborator Author

ammar-agent commented Jan 9, 2026

@codex review

Addressed additional review comments:

  • P2: Now accumulating raw stdout bytes to preserve blank lines (LineBuffer drops empty lines for streaming display, but the final output preserves them)
  • P3: Now restoring input when command produces no output (consistent with other error paths)

chatgpt-codex-connector[bot]
chatgpt-codex-connector bot reviewed Jan 9, 2026
View reviewed changes
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 04ddac9a3d

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@ammar-agent
Copy link
Collaborator Author

ammar-agent commented Jan 9, 2026

@codex review

chatgpt-codex-connector[bot]
chatgpt-codex-connector bot reviewed Jan 9, 2026
View reviewed changes
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 11cc4f1b8e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@ammar-agent
feat: add custom executable slash commands (.mux/commands/)
be8e38e 
Adds support for custom slash commands that run executables in the workspace.

## Features

- **Discovery**: Executables at `.mux/commands/<name>` are discovered and
  appear in slash command autocomplete.

- **Execution**: `/<name> [args...]` runs the command with:
  - First line tokens become argv
  - Lines after the first become stdin
  - Stdout streams in real-time via init events
  - Stdout becomes the user message on success

- **Environment**: Commands receive MUX_* env vars (project path, runtime,
  workspace name, workspace path).

## Implementation

- Backend: SlashCommandService for discovery and execution with streaming
- Frontend: Parser extended with rawInput for unknown commands
- Frontend: ChatInput wired to execute custom commands and show autocomplete
- Docs: New page at docs/hooks/slash-commands.mdx

## Example

```bash
#!/bin/bash
# .mux/commands/refinement
echo "Refine this:"
cat
```

Then use with: `/refinement\n<text to refine>`
@ammar-agent
fix: address review comments and add UI tests for slash commands
eb92962 
- Quote command path before exec to handle spaces in workspace paths (P1)
- Preserve stdin whitespace - don't trim multiline input (P2)
- Add exit code 2 handling: show output but don't send to model
- Update docs with progressive examples (static msg, args, stdin)
- Add comprehensive UI integration tests for custom slash commands
- Add unit tests for custom command suggestions
@ammar-agent
tests: replace flaky UI tests with backend integration tests
68a249c 
- Remove UI integration tests that were timing out in CI
- Add backend integration tests for slash command functionality:
  - Command discovery (list)
  - Command execution (run)
  - Exit code handling (0, 2, others)
  - Argument and stdin passing
@ammar-agent
fix: address additional Codex review comments
a7e2881 
- P2: Preserve blank lines in command stdout by accumulating raw bytes
  instead of using LineBuffer (which drops empty lines)
- P3: Restore input when command produces no output (consistent error handling)
@ammar-agent
fix: use separate TextDecoder per stream to avoid cross-stream corrup…
059afb2 
…tion
@ammar-agent
fix: cap and flush slash command stdout
818b30b
@ammar-agent
tests: add UI smoke test for custom slash commands
825fabf
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@chatgpt-codex-connector chatgpt-codex-connector[bot] chatgpt-codex-connector[bot] left review comments

Assignees

No one assigned

Labels

docs Improvements or additions to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ammar-agent