setup-shell
/setup-shell
Install or refresh Agent Guard's plugin-local shell integration. Use when the user explicitly asks to enable or update shell command masking, or when a shell-integration warning directs them to rerun setup-shell.
- Author
- JeongJaeSoon ↗
- Repository
- agent-guard ↗
- Licence
- MIT
- Last repository change
- 28.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Install or refresh Agent Guard's plugin-local shell integration. Use when the user explicitly asks to enable or update shell command masking, or when a shell-integration warning directs them to rerun setup-shell.
Original author description
Install or refresh Agent Guard's plugin-local shell integration. Use when the user explicitly asks to enable or update shell command masking, or when a shell-integration warning directs them to rerun setup-shell.
How it works
- Workflow
SKILL.md preview
--- name: setup-shell description: Install or refresh Agent Guard's plugin-local shell integration. Use when the user explicitly asks to enable or update shell command masking, or when a shell-integration warning directs them to rerun setup-shell. --- # Set Up Agent Guard Shell Install or refresh Agent Guard shell command masking without making the user locate the versioned plugin-cache binary. ## Workflow 1. Explain that this changes the user's shell rc and is separate from plugin hook setup. 2. Resolve `../../bin/agent-guard` relative to this skill directory and confirm that it is executable. Use that plugin-local binary even if another `agent-guard` is on `PATH`; do not install or update a standalone copy. 3. Tell the user that `setup-shell` will update the managed block in their shell rc with command wrapping enabled by default. Obtain host approval for the home-directory write before running: ```sh "<plugin-local-agent-guard>" setup-shell ``` 4. On success, report every rc path from the command output and tell the user to restart the shell and any agent sessions launched from that shell. A fish login shell gets two rc files (the integration is POSIX shell code that fish cannot load, and agent shell snapshots run bash or zsh); relay the fish notice from the output as-is, including that no automatic `agx` is installed at a fish prompt, a bare `agent-guard` may be unavailable for plugin-only installs, and the command prints an executable path that works without `PATH`. 5. If the approved write is blocked by the host sandbox, relay the exact error. Do not retry the same blocked write, choose another rc, or edit the rc by hand. Show the exact plugin-local command for the user to run directly in a terminal, wait for confirmation, and then report the required restarts. Use `setup-shell --no-command-wrapping` only when the user explicitly requests the persistent opt-out. `AGENT_GUARD_COMMAND_WRAPPING=off` is the runtime-only opt-out.
Versions
The database has no other skills named setup-shell.
Database snapshot: 13.11.2026 · package version 81bd26dedf04 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100setup-agent-guard
Diagnose, install, and verify Agent Guard's plugin-local binary, jq and gitleaks dependencies, the active host integration, and live hook protection. Use when Agent Guard reports degraded protection, a SessionStart warning asks for setup, plugin hooks fail or appear bypassed, or… - 100check
Explain what aws-guard would decide for a shell command, or show its effective rules, without running the command. Use when the user asks whether a command would be blocked or need approval, why aws-guard asked, or what the guard covers. - 100setup
Use when the user explicitly asks to initialize, install, repair, refresh, or bootstrap repository documentation with EZPowers project-local workflow tooling. - 90setup
Initialize or update a project's workflow preferences in its root AGENTS.md. Use only when the user explicitly requests setup or project instruction configuration. Never select this skill automatically for ordinary work. - 100letter-shell-integration
Use when integrating, porting, configuring, or debugging letter-shell command shells, UART shell transport, command registration, RTOS shell tasks, or embedded debug consoles - 100shell-review
Audits shell scripts for correctness, portability, and common pitfalls. Use when reviewing shell scripts or before committing shell changes.