# Ssh Ops

> Use for SSH and remote shell tasks through the shell-only ssh-ops wrappers (`scripts/ssh_ops.sh`). Supports ad-hoc host/user/auth, command execution, guarded PTY workflows, scp copy, credentials, and transcript-aware troubleshooting.

- Skill: `oilproducts/ssh-ops` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add oilproducts/ssh-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oilproducts/ssh-ops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: OilProducts (https://skillmd.com/u/oilproducts)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/oilproducts/ssh-ops

---


# SSH Ops

Use shell wrappers only.

## Preflight
1. Confirm wrapper exists: `/Users/chris/projects/ssh-ops/scripts/ssh_ops.sh`.
2. Confirm system SSH exists: `/usr/bin/ssh`.
3. Decide state-dir strategy:
   - default: wrapper auto-uses `/tmp/ssh-ops-$USER/<cwd-hash>`
   - explicit: pass `--state-dir /tmp/ssh-ops-<name>` (recommended for long sessions and scripts)

## Policy
- Use `scripts/ssh_ops.sh` commands only.
- Keep the same state dir across session-open/exec/pty/scp/session-close for continuity.
- Default to non-PTY command execution.
- PTY only when needed, with strict guardrails and override flag.
- Report exit codes, stderr summary, and transcript offsets.

## Core Workflow
1. Open or reuse session: `session-open` / `session-list`.
2. Execute remote work with `exec` (default) or guarded `pty-*`.
3. Use `scp-copy` when file transfer is needed.
4. Close session with `session-close`.

See `references/workflows.md` and `references/policies.md`.

## Credentials
1. Save credential: `credential-save`.
2. List credentials: `credential-list`.
3. Delete credentials: `credential-delete`.

## Error Handling
Use `references/errors.md`.