Skip to content

Add one-time commands, scripts directory, and native notifications #4

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

Merged
vim-zz merged 4 commits into from
Mar 4, 2026
Merged

Add one-time commands, scripts directory, and native notifications #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5cd6713
Add one-time commands, scripts directory, native notifications, and c…
MishaKav Mar 4, 2026
9de0206
Merge origin/main into feature/one-time-commands
MishaKav Mar 4, 2026
5dc57f2
Add missing AppPaths import in Linux app
MishaKav Mar 4, 2026
66fa9b4
Shorten v1.8.0 release notes
MishaKav Mar 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,8 @@
- Emit logs through `log`/`oslog` with concise context fields so Console filtering remains effective.

## Architecture & Design Patterns
- **Core components:** `main.rs` (Cocoa setup, initialization, run loop), `app.rs` (main state with `TunnelManager` and status item wrapper), `config.rs` (TOML config load/manage), `menu.rs` (NSStatusItem + NSMenu creation and icon handling), `tunnel.rs` (SSH/port-forward lifecycle), `logger.rs` (oslog configuration).
- **Key patterns:** thread-safe global state via `OnceLock<App>`, thread-safe Cocoa wrappers, Objective-C bridge class for menu callbacks, async threads for long-running tunnel commands.
- **Core components:** `main.rs` (Cocoa setup, initialization, run loop), `app.rs` (main state with `TunnelManager`, `CommandRunner`, and status item wrapper), `config.rs` (TOML config load/manage, script auto-discovery), `command.rs` (one-time command execution with silent/notify/terminal output modes), `menu.rs` (NSStatusItem + NSMenu creation and icon handling), `tunnel.rs` (SSH/port-forward lifecycle), `logger.rs` (oslog configuration).
- **Key patterns:** thread-safe global state via `OnceLock<App>`, thread-safe Cocoa wrappers, Objective-C bridge class for menu callbacks, async threads for long-running tunnel commands, callback-based cross-platform dispatch in `CommandRunner`.
- **Dependencies:** cocoa/objc2, core-foundation, log/oslog, libc, toml, serde; patched `objc` fork for compatibility.

## Tunnel Configuration
Expand All @@ -41,6 +41,13 @@
- Supports any command-line tool that can be started/stopped; config uses `#[serde(default)]` on optional fields for backward compatibility.
- Default seed tunnels: `example-ssh`, `k8s-example`, and `colima`.

## One-Time Commands
- `[commands]` config section for fire-and-forget commands (no kill_command needed).
- Each command defines `name`, `command`, `args`, and optional `output` mode (`"silent"` | `"notify"` | `"terminal"`).
- `CommandRunner` in `core/src/command.rs` dispatches execution based on output mode using platform-specific callbacks (notify and terminal).
- `scripts_dir` config option auto-discovers `*.sh` files and adds them as commands with `"notify"` output mode.
- Menu order: Tunnels → Commands → Scheduled Tasks → system items.

## Configuration Management
- If config loading fails, fall back to hardcoded defaults.
- `path` config entry controls PATH used for child processes; defaults include Homebrew locations.
Expand Down
Loading