Git workflow accelerator for humans and agents
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"jetsam-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# jetsam [](https://pypi.org/project/jetsam/) [](https://jetsam.readthedocs.io) [](https://github.com/teaguesterling/jetsam/actions) Git workflow accelerator for humans and agents. Jetsam wraps common multi-step git workflows into single, plannable commands. Every action generates a preview plan before executing, making it safe for interactive use and ideal for AI agent integration via MCP. **[Documentation](https://jetsam-mcp.readthedocs.io)** | **[PyPI](https://pypi.org/project/jetsam-mcp/)** | **[GitHub](https://github.com/teaguesterling/jetsam)** ## Installation ```bash pip install jetsam-mcp # or uv pip install jetsam-mcp ``` ## Quick start ```bash # Initialize in a repo jetsam init # Check status jetsam status # Stage + commit jetsam save -m "fix parser bug" # Full pipeline: stage → commit → push → PR jetsam ship -m "add dark mode" # Tag and release jetsam release v0.1.0 --title "First release" ``` Every command shows a plan and asks for confirmation before executing. Use `--dry-run` to preview without executing, or `--execute` to skip the prompt. ## Verb reference | Verb | Alias | Description | |---|---|---| | `status` | `s` | Show repository state snapshot | | `save` | `v` | Stage and commit with smart defaults | | `sync` | `y` | Fetch, rebase/merge, and push | | `ship` | `h` | Full pipeline: stage, commit, push, open PR | | `switch` | `w` | Switch branches with automatic stash/unstash | | `start` | `b` | Start work on an issue or feature (branch or worktree) | | `finish` | `f` | Merge PR and clean up branch | | `tidy` | `t` | Prune merged branches and stale remote refs | | `release` | `r` | Tag, push tag, and create platform release | | `log` | `l` | Condensed commit history | | `diff` | `d` | Show diff with smart defaults | | `pr` | `p` | Pull req…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.