tembo-cli
npx skills add https://github.com/tryosschat/tembo-cli --skill tembo-cli
Agent 安装分布
Skill 文档
Tembo CLI Skill
A CLI tool for interacting with the Tembo Public API – manage AI coding tasks and repositories programmatically.
When to Use This Skill
Use this skill when:
- Creating coding tasks for Tembo AI agents
- Listing and searching existing tasks
- Managing repository connections
- Automating Tembo workflows in CI/CD pipelines
- Building custom integrations with Tembo
Installation
bun add -g github:tryosschat/tembo-cli
Authentication
Get your API key from app.tembo.io â Settings â API Keys.
# Set your API key
tembo-cli auth login YOUR_API_KEY
# Verify authentication
tembo-cli auth whoami
# Check status
tembo-cli auth status
You can also set the TEMBO_API_KEY environment variable.
Permissions
Important: Agents using this skill MUST ask for explicit user confirmation before running any command that modifies state. This includes:
tasks createâ creates a new coding task (costs compute, triggers an AI agent)auth login/auth logoutâ modifies stored credentials
Read-only commands (tasks list, tasks search, repos list, auth whoami, auth status) are safe to run without confirmation.
Example: Before creating a task, always confirm:
“I’d like to create a Tembo task: Fix the login bug on repo
myorg/myapp. Should I proceed?”
Never run background tasks or batch-create tasks without the user explicitly allowing it.
Commands
Authentication
| Command | Description |
|---|---|
tembo-cli auth login <key> |
Save API key (validates against API) |
tembo-cli auth logout |
Remove stored API key |
tembo-cli auth whoami |
Show current user/organization |
tembo-cli auth status |
Show config path and key status |
Tasks
| Command | Description |
|---|---|
tembo-cli tasks list |
List tasks (--page, --limit, --json) |
tembo-cli tasks search <query> |
Search tasks (--limit, --json) |
tembo-cli tasks create <prompt> |
Create a new task |
Create Task Options
tembo-cli tasks create "Fix the login bug" \
--agent "claudeCode:claude-4-5-sonnet" \
--repo "https://github.com/org/repo" \
--branch "main"
| Option | Description |
|---|---|
-a, --agent <agent> |
Agent to use (default: claudeCode:claude-opus-4-5) |
-r, --repo <urls...> |
Repository URLs |
-b, --branch <branch> |
Target branch |
--no-queue |
Don’t start task immediately |
--json |
Output as JSON |
Repositories
| Command | Description |
|---|---|
tembo-cli repos list |
List enabled repositories (--json) |
Available Agents
Tembo supports multiple coding agents:
| Agent | Format |
|---|---|
| Claude Opus | claudeCode:claude-opus-4-5 |
| Claude Sonnet | claudeCode:claude-4-5-sonnet |
| OpenAI Codex | codex:... |
Examples
Create a Bug Fix Task
tembo-cli tasks create "Fix the authentication bug in the login component" \
--repo "https://github.com/myorg/myapp" \
--branch "main"
Create Task with Sonnet (Faster)
tembo-cli tasks create "Add input validation to the signup form" \
--agent "claudeCode:claude-4-5-sonnet" \
--repo "https://github.com/myorg/myapp"
List Recent Tasks as JSON
tembo-cli tasks list --limit 5 --json
Search for Specific Tasks
tembo-cli tasks search "authentication" --limit 10
CI/CD Integration
# In GitHub Actions or similar
export TEMBO_API_KEY=${{ secrets.TEMBO_API_KEY }}
tembo-cli tasks create "Fix failing tests in PR #${PR_NUMBER}" \
--repo "$GITHUB_REPOSITORY" \
--branch "$GITHUB_HEAD_REF"
API Reference
The CLI wraps the Tembo Public API at https://api.tembo.io:
| Endpoint | CLI Command |
|---|---|
GET /me |
auth whoami |
POST /task/create |
tasks create |
GET /task/list |
tasks list |
GET /task/search |
tasks search |
GET /repository/list |
repos list |
Configuration
Config is stored at ~/.tembo-cli/config.json:
{
"apiKey": "your-api-key",
"apiUrl": "https://api.tembo.io"
}
Error Handling
The CLI provides clear error messages:
| Code | Meaning |
|---|---|
| 401 | Invalid or missing API key |
| 429 | Rate limited (100 req/min, 1000 req/hr) |
| 500 | Server error |
Troubleshooting
“No API key found”
tembo-cli auth login YOUR_API_KEY
# or
export TEMBO_API_KEY=YOUR_API_KEY
“Invalid API key” Regenerate your key at app.tembo.io â Settings â API Keys
“Rate limited” Wait a minute and retry. Consider batching requests.