Skip to content

v0.5.0 — pskt status + shell completions

Choose a tag to compare

@Alecell Alecell released this 10 May 22:49
· 10 commits to main since this release

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