Terminal Shop Plugin

Order coffee and merchandise from Terminal Shop - the developer-focused coffee company.

Features

• Browse products and variants
• Manage shopping cart
• Create and manage shipping addresses
• Handle payment methods
• Place orders
• Set up recurring subscriptions
• View order history and tracking

Setup

1. Get Your API Token

Terminal Shop uses SSH-based authentication. Follow these steps:

ssh terminal.shop

If prompted about host authenticity, type yes to continue.

Once connected to the Terminal Shop TUI:

1. Press a to open Account
2. Use arrow keys to navigate to "access tokens"
3. Press Enter to create a new token
4. Copy the token - it will be in this format: trm_live_[...]

2. Configure the Plugin

cp .env.example .env

Edit .env and add your token:

TERMINAL_BEARER_TOKEN=trm_live_your_token_here

3. Test Connection

opencode run "test terminal shop connection"

Usage

Browse Products

opencode run "list all terminal shop products"
opencode run "get details for product prod_xxx"

Shopping Cart

opencode run "show my terminal shop cart"
opencode run "add 2 bags of coffee variant var_xxx to my cart"
opencode run "clear my terminal shop cart"

Checkout Flow

opencode run "list my saved addresses"
opencode run "create a new shipping address"
opencode run "set shipping address for my cart"
opencode run "checkout and place my order"

Order History

opencode run "show my order history"
opencode run "get details for order ord_xxx"

Subscriptions

opencode run "list my coffee subscriptions"
opencode run "create a bi-weekly coffee subscription"
opencode run "cancel my subscription"

Available Tools

| Tool | Description | |------|-------------| | terminal-shop-test-connection | Test API connection and account status | | terminal-shop-list-products | List all available products | | terminal-shop-get-product | Get product details | | terminal-shop-get-profile | Get user profile | | terminal-shop-update-profile | Update user profile | | terminal-shop-get-cart | View shopping cart | | terminal-shop-add-to-cart | Add/update cart items | | terminal-shop-clear-cart | Clear all cart items | | terminal-shop-set-cart-address | Set cart shipping address | | terminal-shop-set-cart-card | Set cart payment method | | terminal-shop-checkout | Convert cart to order | | terminal-shop-list-addresses | List saved addresses | | terminal-shop-get-address | Get address details | | terminal-shop-create-address | Create new address | | terminal-shop-delete-address | Delete an address | | terminal-shop-list-cards | List saved payment cards | | terminal-shop-get-card | Get card details | | terminal-shop-delete-card | Delete a card | | terminal-shop-get-card-collection-url | Get Stripe card collection URL | | terminal-shop-list-orders | List order history | | terminal-shop-get-order | Get order details | | terminal-shop-create-order | Create direct order (skip cart) | | terminal-shop-list-subscriptions | List active subscriptions | | terminal-shop-get-subscription | Get subscription details | | terminal-shop-create-subscription | Create recurring subscription | | terminal-shop-update-subscription | Update subscription settings | | terminal-shop-cancel-subscription | Cancel a subscription | | terminal-shop-list-tokens | List API tokens | | terminal-shop-create-token | Create new API token | | terminal-shop-delete-token | Delete an API token | | terminal-shop-init-view | Get available regions |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | TERMINAL_BEARER_TOKEN | Yes | Bearer token for API authentication | | TERMINAL_ENVIRONMENT | No | production (default) or dev |