# Tether

> Tether (install/uninstall) hooks for auto-backup on session end. Renamed from 'hooks' to avoid clashing with Claude Code's.

- **Type:** Skill
- **Install:** `agentstack add skill-terrylica-cc-skills-tether`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [terrylica](https://agentstack.voostack.com/s/terrylica)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [terrylica](https://github.com/terrylica)
- **Source:** https://github.com/terrylica/cc-skills/tree/main/plugins/asciinema-tools/skills/tether

## Install

```sh
agentstack add skill-terrylica-cc-skills-tether
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /asciinema-tools:tether

Manage Claude Code hooks for asciinema-tools automation.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Arguments

| Argument            | Description                     |
| ------------------- | ------------------------------- |
| `install`           | Add hooks to settings.json      |
| `uninstall`         | Remove asciinema-tools hooks    |
| `status`            | Show current hook configuration |
| `--backup-on-stop`  | Auto-backup when session ends   |
| `--convert-on-stop` | Auto-convert on session end     |
| `-y, --yes`         | Skip confirmation prompts       |

## Hook Definitions

### PostToolUse Hook (backup-on-stop)

```json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "command": "asciinema-backup-if-active"
      }
    ]
  }
}
```

## Execution

### Skip Logic

- If action provided -> execute directly
- If hook type flags provided -> use specific hooks

### Workflow

1. **Status**: Read current ~/.claude/settings.json
2. **Action**: AskUserQuestion for action type
3. **Hooks**: AskUserQuestion for hook selection
4. **Execute**: Modify settings.json
5. **Verify**: Confirm changes applied

## Examples

```bash
# Check current hook status
/asciinema-tools:tether status

# Install auto-backup hook
/asciinema-tools:tether install --backup-on-stop

# Install without prompts
/asciinema-tools:tether install -y

# Remove all asciinema hooks
/asciinema-tools:tether uninstall
```

## Troubleshooting

| Issue                   | Cause                    | Solution                          |
| ----------------------- | ------------------------ | --------------------------------- |
| jq not found            | jq not installed         | `brew install jq`                 |
| Settings file not found | ~/.claude/ doesn't exist | Create with `mkdir -p ~/.claude`  |
| Hooks not working       | Session not restarted    | Restart Claude Code session       |
| Backup not triggering   | No active recordings     | Start recording first with daemon |

## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [terrylica](https://github.com/terrylica)
- **Source:** [terrylica/cc-skills](https://github.com/terrylica/cc-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-terrylica-cc-skills-tether
- Seller: https://agentstack.voostack.com/s/terrylica
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.