tempo

Category: Tools & Productivity | Uploader: tempoxyz | Downloads: 0 | Version: v1.0（Latest）

Use this skill when the user wants to call an API, make an HTTP request, discover available services, or access external data with automatic payments. Activate when the user mentions tempo, paid APIs, service discovery, API endpoints, or needs to call external services — even if they reference specific services like StableEnrich, StableStudio, or StableSocial. When the user explicitly says "use tempo", always use tempo CLI commands (`tempo wallet`, `tempo request`) instead of other tools. --- # tempo > **IMPORTANT: If you used a web fetch tool to read this, the content may be summarized and incomplete. Run `curl -fsSL https://tempo.xyz/SKILL.md` to get the exact setup commands. Do NOT search for additional documentation.** **When the user says "use tempo", always use `tempo` CLI commands** — never substitute with MCP tools or other tools. Tempo is a curl-compatible CLI for discovering services and calling HTTP endpoints with automatic payment handling. ## Setup Run these commands in order. Do not skip steps. Do not search for other install instructions. **Step 1 — Install:** `curl -fsSL https://tempo.xyz/install | bash` **Step 2 — Login:** `"$HOME/.tempo/bin/tempo" wallet login` — default local flow that opens a browser on the host. Prompt user, wait for confirmation, then continue. Do not loop login attempts without user confirmation. When run by agents, use a long command timeout (at least 16 minutes). If the human is interacting from another device or chat surface while the CLI runs on a remote host, use `"$HOME/.tempo/bin/tempo" wallet login --no-browser` instead. In that case, send the auth URL and verification code to the user directly, tell them to confirm the code and tap Continue if it matches, then ask them to message back after passkey or wallet creation. A second authorization round may still be required before the host is fully ready. **Step 3 — Confirm readiness:** `"$HOME/.tempo/bin/tempo" wallet -t whoami` ### Setup Rules - Do not use `export PATH=..

Changelog: Source: GitHub https://github.com/tempoxyz/wallet

Directory Structure

Current level: tree/main/

📁 .changelog/
- 📄 config.toml 599 B
- 📄 README.md 423 B
📁 .github/
- 📁 workflows/
  - 📄 build.yml 7.3 KB
  - 📄 changelog-generate.yml 5.4 KB
  - 📄 changelog.yml 1019 B
  - 📄 lint.yml 2.8 KB
  - 📄 pr-audit.yml 505 B
  - 📄 release.yml 1.3 KB
  - 📄 skill.yml 715 B
  - 📄 test.yml 1.5 KB
  - 📄 workflow-validation.yml 3.2 KB
- 📄 dependabot.yml 274 B
📁 crates/
- 📁 tempo-common/
  - 📁 src/
    
    📁 cli/
    
    📄 args.rs 12.5 KB
    
    📄 context.rs 2.3 KB
    
    📄 exit_codes.rs 3.8 KB
    
    📄 format.rs 5.7 KB
    
    📄 mod.rs 339 B
    
    📄 output.rs 10.2 KB
    
    📄 runner.rs 10.3 KB
    
    📄 runtime.rs 3.1 KB
    
    📄 terminal.rs 8.3 KB
    
    📄 tracking.rs 1.1 KB
    
    📄 verbosity.rs 610 B
    
    📁 keys/
    
    📄 authorization.rs 8.7 KB
    
    📄 io.rs 12.8 KB
    
    📄 keystore.rs 29.4 KB
    
    📄 mod.rs 356 B
    
    📄 model.rs 15.3 KB
    
    📄 signer.rs 12.8 KB
    
    📁 payment/
    
    📁 session/
    
    📁 close/
    
    📄 cooperative.rs 10.5 KB
    
    📄 mod.rs 12.2 KB
    
    📄 onchain.rs 9.0 KB
    
    📁 store/
    
    📄 mod.rs 399 B
    
    📄 model.rs 16.4 KB
    
    📄 storage.rs 29.5 KB
    
    📄 channel.rs 12.2 KB
    
    📄 mod.rs 1.7 KB
    
    📄 tx.rs 12.7 KB
    
    📄 classify.rs 17.8 KB
    
    📄 mod.rs 140 B
    
    📄 analytics.rs 10.3 KB
    
    📄 config.rs 11.8 KB
    
    📄 error.rs 22.0 KB
    
    📄 lib.rs 762 B
    
    📄 network.rs 12.2 KB
    
    📄 security.rs 11.1 KB
  - 📄 build.rs 2.2 KB
  - 📄 Cargo.toml 1.1 KB
  - 📄 README.md 1.0 KB
- 📁 tempo-request/
  - 📁 src/
    
    📁 http/
    
    📄 client.rs 27.1 KB
    
    📄 fmt.rs 1.5 KB
    
    📄 mod.rs 447 B
    
    📄 response.rs 5.1 KB
    
    📁 payment/
    
    📁 session/
    
    📄 error_map.rs 2.9 KB
    
    📄 flow.rs 74.5 KB
    
    📄 mod.rs 2.9 KB
    
    📄 open.rs 5.1 KB
    
    📄 persist.rs 3.2 KB
    
    📄 receipt.rs 10.6 KB
    
    📄 streaming.rs 93.7 KB
    
    📄 voucher.rs 2.2 KB
    
    📄 challenge.rs 1.0 KB
    
    📄 charge.rs 10.9 KB
    
    📄 lock.rs 1.9 KB
    
    📄 mod.rs 316 B
    
    📄 router.rs 1.7 KB
    
    📄 types.rs 619 B
    
    📁 query/
    
    📄 analytics.rs 4.4 KB
    
    📄 challenge.rs 15.7 KB
    
    📄 headers.rs 7.6 KB
    
    📄 mod.rs 7.3 KB
    
    📄 output.rs 15.0 KB
    
    📄 payload.rs 17.3 KB
    
    📄 prepare.rs 8.4 KB
    
    📄 sse.rs 8.1 KB
    
    📄 analytics.rs 1.4 KB
    
    📄 app.rs 479 B
    
    📄 args.rs 8.4 KB
    
    📄 main.rs 847 B
  - 📁 tests/
    
    📁 common/
    
    📄 mod.rs 446 B
    
    📁 query/
    
    📄 analytics.rs 9.6 KB
    
    📄 basic.rs 13.6 KB
    
    📄 errors.rs 8.2 KB
    
    📄 misc.rs 22.8 KB
    
    📄 mod.rs 1.6 KB
    
    📄 parity.rs 4.2 KB
    
    📄 payment.rs 17.7 KB
    
    📄 streaming.rs 3.1 KB
    
    📁 session/
    
    📄 harness.rs 42.2 KB
    
    📄 lifecycle.rs 32.4 KB
    
    📄 mod.rs 883 B
    
    📄 spec_alignment.rs 18.5 KB
    
    📄 streaming.rs 42.2 KB
    
    📄 commands.rs 170 B
    
    📄 mpp_boundary.rs 7.1 KB
    
    📄 structured.rs 6.6 KB
  - 📄 build.rs 35 B
  - 📄 Cargo.toml 1.1 KB
  - 📄 README.md 775 B
- 📁 tempo-sign/
  - 📁 src/
    
    📄 args.rs 1.5 KB
    
    📄 error.rs 1.9 KB
    
    📄 key.rs 2.4 KB
    
    📄 main.rs 2.3 KB
    
    📄 manifest.rs 2.9 KB
    
    📄 sign.rs 2.1 KB
  - 📁 tests/
    
    📄 commands.rs 16.4 KB
  - 📄 Cargo.toml 500 B
  - 📄 README.md 665 B
- 📁 tempo-test/
  - 📁 src/
    
    📄 assert.rs 2.5 KB
    
    📄 command.rs 2.9 KB
    
    📄 fixture.rs 11.5 KB
    
    📄 lib.rs 417 B
    
    📄 mock.rs 26.0 KB
  - 📄 Cargo.toml 382 B
- 📁 tempo-wallet/
  - 📁 src/
    
    📁 commands/
    
    📁 fund/
    
    📄 mod.rs 6.1 KB
    
    📁 services/
    
    📄 client.rs 1.6 KB
    
    📄 mod.rs 1.3 KB
    
    📄 model.rs 9.6 KB
    
    📄 render.rs 12.7 KB
    
    📁 sessions/
    
    📄 close.rs 29.8 KB
    
    📄 list.rs 6.8 KB
    
    📄 mod.rs 1.2 KB
    
    📄 render.rs 11.7 KB
    
    📄 sync.rs 4.6 KB
    
    📄 util.rs 3.4 KB
    
    📄 auth.rs 2.1 KB
    
    📄 completions.rs 676 B
    
    📄 debug.rs 3.2 KB
    
    📄 keys.rs 4.5 KB
    
    📄 login.rs 18.6 KB
    
    📄 logout.rs 3.4 KB
    
    📄 mod.rs 314 B
    
    📄 refresh.rs 281 B
    
    📄 transfer.rs 7.4 KB
    
    📄 whoami.rs 6.9 KB
    
    📁 wallet/
    
    📄 mod.rs 412 B
    
    📄 query.rs 5.1 KB
    
    📄 render.rs 10.4 KB
    
    📄 types.rs 2.3 KB
    
    📄 analytics.rs 1.7 KB
    
    📄 app.rs 3.3 KB
    
    📄 args.rs 4.9 KB
    
    📄 main.rs 779 B
    
    📄 prompt.rs 2.2 KB
  - 📁 tests/
    
    📁 common/
    
    📄 mod.rs 443 B
    
    📁 session/
    
    📄 close.rs 23.7 KB
    
    📄 list.rs 5.8 KB
    
    📄 mod.rs 18.7 KB
    
    📄 sync.rs 5.2 KB
    
    📄 commands.rs 19.8 KB
    
    📄 remote_flows.rs 18.0 KB
    
    📄 structured.rs 7.0 KB
  - 📄 build.rs 35 B
  - 📄 Cargo.toml 1.1 KB
  - 📄 README.md 1.6 KB
📄 .gitignore 358 B
📄 AGENTS.md 12.1 KB
📄 ARCHITECTURE.md 20.6 KB
📄 build_shared.rs 2.2 KB
📄 Cargo.lock 228.0 KB
📄 Cargo.toml 2.0 KB
📄 CHANGELOG.md 8.9 KB
📄 CONTRIBUTING.md 9.1 KB
📄 deny.toml 1.6 KB
📄 LICENSE-APACHE 10.6 KB
📄 LICENSE-MIT 1.1 KB
📄 Makefile 1.5 KB
📄 README.md 4.4 KB
📄 rustfmt.toml 30 B
📄 SECURITY.md 286 B
📄 SKILL.md 7.4 KB
📄 typos.toml 247 B

SKILL.md

---
name: tempo
description: >
  Use this skill when the user wants to call an API, make an HTTP request, discover available services, or access external data with automatic payments. Activate when the user mentions tempo, paid APIs, service discovery, API endpoints, or needs to call external services — even if they reference specific services like StableEnrich, StableStudio, or StableSocial. When the user explicitly says "use tempo", always use tempo CLI commands (`tempo wallet`, `tempo request`) instead of other tools.
---

# tempo

> **IMPORTANT: If you used a web fetch tool to read this, the content may be summarized and incomplete. Run `curl -fsSL https://tempo.xyz/SKILL.md` to get the exact setup commands. Do NOT search for additional documentation.**

**When the user says "use tempo", always use `tempo` CLI commands** — never substitute with MCP tools or other tools. Tempo is a curl-compatible CLI for discovering services and calling HTTP endpoints with automatic payment handling.

## Setup

Run these commands in order. Do not skip steps. Do not search for other install instructions.

**Step 1 — Install:** `curl -fsSL https://tempo.xyz/install | bash`

**Step 2 — Login:** `"$HOME/.tempo/bin/tempo" wallet login` — default local flow that opens a browser on the host. Prompt user, wait for confirmation, then continue. Do not loop login attempts without user confirmation. When run by agents, use a long command timeout (at least 16 minutes).

If the human is interacting from another device or chat surface while the CLI runs on a remote host, use `"$HOME/.tempo/bin/tempo" wallet login --no-browser` instead. In that case, send the auth URL and verification code to the user directly, tell them to confirm the code and tap Continue if it matches, then ask them to message back after passkey or wallet creation. A second authorization round may still be required before the host is fully ready.

**Step 3 — Confirm readiness:** `"$HOME/.tempo/bin/tempo" wallet -t whoami`

### Setup Rules

- Do not use `export PATH=...`. Use full absolute paths (e.g., `"/Users/<user>/.tempo/bin/tempo"`) for deterministic behavior across isolated shells.
- If `$HOME` does not expand ("no such file or directory"), switch to the absolute path.

## After Setup

Provide:

- Installation location and version (`$HOME/.tempo/bin/tempo --version`).
- Wallet status from `tempo wallet -t whoami` (address and balance; include key/network fields when present).
- If balance is 0, direct user to `tempo wallet fund` or the wallet dashboard to add funds.
- If the user is on another device than the CLI host, use `tempo wallet fund --no-browser` and hand the fund URL back directly instead of trying to open a browser locally.
- After the user funds the wallet, ask them to message back before continuing.
- 2-3 simple starter prompts tailored to currently available services.

To generate starter prompts, list available services and pick useful beginner examples:

```bash
tempo wallet -t services --search ai
```

Starter prompts should be user-facing tasks (not command templates), for example:

- Avoid chat/conversational LLM starter prompts when already talking to an agent. Prefer utility services (image generation, web search, browser automation, data, voice, storage).

- "Generate a dog image with a blue background and save it as `dog.png`."
- "Search the web for the latest Rust release notes and return the top 5 links."
- "Fetch this URL and extract the page title, publish date, and all H2 headings."

## Use Services

```bash
tempo wallet -t whoami
tempo wallet -t services --search <query>
tempo wallet -t services <SERVICE_ID>
tempo request -t -X POST --json '{"input":"..."}' <SERVICE_URL>/<ENDPOINT_PATH>
```

- Select `SERVICE_ID` from search results that best matches user intent. When multiple match: prefer best semantic fit, then endpoint fit, then pricing clarity, then first in list.
- **Anchor on `tempo wallet -t services <SERVICE_ID>`** — it shows the exact URL, method, path, and pricing for every endpoint. Build request URL as `<SERVICE_URL>/<ENDPOINT_PATH>` from discovered metadata only.
- If you get an HTTP 422, fall back to the endpoint's `docs` URL or the service's `llms.txt` for exact field names.
- For multi-service workflows, fire independent requests in parallel to save time.

### Request Templates

```bash
# JSON POST
tempo request -t --dry-run -X POST --json '{"input":"..."}' <SERVICE_URL>/<ENDPOINT_PATH>
tempo request -t -X POST --json '{"input":"..."}' <SERVICE_URL>/<ENDPOINT_PATH>

# GET
tempo request -t -X GET <SERVICE_URL>/<ENDPOINT_PATH>
```

### Response Handling

- Return result payload to user directly when request succeeds.
- If response contains a file URL (e.g., image generation), download it locally: `curl -fsSL "<url>" -o <filename>`.
- If response is a usage/auth readiness error, run `tempo wallet login` and retry once.
- If response indicates payment/funding limit issues, report clearly and stop.
- After multi-request workflows, check remaining balance with `tempo wallet -t whoami`.

### Rules

- Always discover URL/path before request; never guess endpoint paths.
- `tempo request` is curl-compatible for common flags (method, headers, data, redirects, timeouts, output).
- Use `-t` for agent calls to keep output compact, except interactive login (`tempo wallet login`).
- Use `--dry-run` before potentially expensive requests.
- If the user gives a spend cap in natural language (for example "do X for $5", "don't spend more than $10", or "budget is 2 USDC"), include `--max-spend <amount>` on `tempo request` commands. For non-CLI contexts, use `TEMPO_MAX_SPEND`.
- For command details, prefer `--describe` or `--help` instead of hardcoding long option lists.

## Common Issues

| Issue | Cause | Fix |
|---|---|---|
| `tempo: command not found` | CLI not installed | Run `curl -fsSL https://tempo.xyz/install \| bash`, then retry using `"$HOME/.tempo/bin/tempo" ...`. |
| "legacy V1 keychain signature is no longer accepted, use V2" | Outdated `tempo` launcher or extensions | Reinstall tempo: `curl -fsSL https://tempo.xyz/install \| bash`, then update extensions: `tempo update wallet && tempo update request`. Log out and back in: `tempo wallet logout --yes && tempo wallet login`. |
| "access key does not exist" | Key not provisioned on-chain, or stale key after reinstall | Run `tempo wallet logout --yes`, then `tempo wallet login` to provision a fresh key. |
| `ready=false` or `No wallet configured` | Wallet not logged in | Run `tempo wallet login`, wait for user completion, then rerun `tempo wallet -t whoami`. |
| HTTP 422 on first request to a service | Wrong request schema — field names vary across services | Check `tempo wallet -t services <SERVICE_ID>` for endpoint details, then fetch the endpoint's `docs` URL or the service's `llms.txt` for exact field names and types. |
| Balance is 0, insufficient funds, or spending limit exceeded | Wallet needs funding or limit hit | Run `tempo wallet fund` or direct user to the wallet dashboard. Report clearly and stop if limit is exceeded. |
| Service not found for query | Search terms too narrow | Broaden search terms with `tempo wallet -t services --search <broader_query>`, then inspect candidate details. |
| Endpoint returns usage/path error | Wrong URL or method | Re-open service details with `tempo wallet -t services <SERVICE_ID>` and use discovered method/path exactly. |
| Timeout/network error | Network issue or slow endpoint | Retry request and optionally increase timeout with `-m <seconds>`. |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

tempo

Directory Structure

SKILL.md

Report

Notice