Repository navigation
v0.5.0 — pskt status + shell completions
Adds a consolidated `pskt status` view and documents tab completion (already shipped by Typer but undocumented before).
What's new
`pskt status`
One screen with everything you usually care about:
```
Registry https://github.com/you/registry
HEAD: abc1234
Local changes: clean
Unpushed: in sync with remote
Registry packages 5 (2 agents, 2 skills, 1 command)
Installations 3 (root: 2, project: 1)
Outdated (1):
agents/my-agent (root) v1.0.0 → v1.2.0 (run `pskt update agents/my-agent`)
Orphaned (1): (installed but no longer in the registry)
agents/old-thing (root) v0.5.0 (run `pskt remove agents/old-thing root` to clean up)
```
What it shows:
- Workspace: clone HEAD, clean/dirty state, count of commits ahead of `origin/main`.
- Registry: total packages, broken down by kind.
- Installations: root + project totals, plus two diagnostic categories:
- Outdated — installed version is older than the registry. Suggests `pskt update`.
- Orphaned — installed but no longer in the registry (someone ran `pskt destroy` upstream). Suggests `pskt remove`.
Shell completions (documented)
Typer has been shipping completion all along; the README now points to it:
```bash
pskt --install-completion # bash / zsh / fish / powershell, autodetected
pskt --show-completion # print the completion script without installing
```
After installing, `pskt ` lists commands, `pskt install --` lists flags, etc. Dynamic completion of package names from the registry is not wired up — completion covers commands and flags only.
Installation
Same as before:
```bash
curl -fsSL https://raw.githubusercontent.com/Alecell/Perskent/main/install.sh | sh
```
Or upgrade:
```bash
pipx upgrade perskent
```
Full command list
| Command | What it does |
|---|---|
| `pskt init` | Configure remote registry, clone workspace |
| `pskt doctor` | Per-check diagnostics |
| `pskt status` | New in v0.5.0 — consolidated view (workspace + registry + installs) |
| `pskt sync` | Pull from remote |
| `pskt find remote` / `pskt find local` | List packages |
| `pskt show ` | Package details |
| `pskt search ` | Search by name/description |
| `pskt install [scope] [--force]` | Install |
| `pskt remove ` | Uninstall |
| `pskt update ` | Upgrade, respecting `[update].preserve` |
| `pskt push [-m ]` | Bump + commit + push |
| `pskt destroy [-m ] [-y]` | Permanently delete from registry |