dock
Connect to the treeship.dev Hub to push, pull, and share artifacts.
Login flow
Start authentication
treeship dock loginThis initiates the RFC 8628 device authorization flow. A fresh Ed25519 dock keypair is generated locally.
Activate in your browser
Visit the URL shown and enter the code:
> visit https://treeship.dev/dock/activate
> code: ABCD-1234
> waiting...Docked
✓ docked
dock id: dck_9f8e7d6c
endpoint: https://api.treeship.devDPoP Security
All Hub requests use RFC 9449 DPoP proof-of-possession. Every request carries a DPoP JWT signed by the dock key. Stolen credentials are useless without the private key.
Options
| Option | Description |
|---|---|
--endpoint <url> | Hub API endpoint (default: https://api.treeship.dev) |
treeship dock push
Push an artifact to the treeship.dev Hub.
treeship dock push art_f7e6d5c4Returns a shareable URL and an optional Rekor transparency log index.
✓ pushed
url: https://treeship.dev/verify/art_f7e6d5c4
rekor: rekor.sigstore.dev #12345treeship dock pull
Pull an artifact from the Hub into your local store. No authentication required -- artifacts are public.
treeship dock pull art_f7e6d5c4✓ pulled
id: art_f7e6d5c4treeship dock status
Show the current dock connection.
treeship dock status● docked
endpoint: https://api.treeship.dev
dock id: dck_9f8e7d6cIf not connected:
○ undocked
hint: treeship dock logintreeship dock undock
Disconnect from the Hub. Clears dock credentials from local config. Does not revoke the dock keypair on the Hub.
treeship dock undock