kumar/tessl-setup

Personal Tessl setup guide — CLI reference for creating plugins/skills, publishing, installing, running evals, and navigating the full plugin lifecycle.

Quality

95%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

name:: tessl-launch
description:: Use when running skills through agents, using the built-in Tessl agent, launching cloud runs against repos, or admin tasks (workspace, API keys, change review). Triggers on: "launch a skill", "run skill with claude", "tessl agent", "cloud run", "workspace add-member", "api-key create", "change review", "risk assessment".

Tessl Launch & Admin

Name: kumar/tessl-setup
Rating: 76.4 (1 reviews)
Author: kumar

Running skills through agents, using the built-in Tessl agent, cloud runs, and workspace/API key administration.

Launch Skills with Agents

# Run locally
tessl launch skill workspace/my-skill --agent tessl-agent
tessl launch skill workspace/my-skill --agent claude-code --interactive
tessl launch skill workspace/my-skill --agent tessl-agent --yolo
tessl launch skill file:./my-skill --agent claude-code   # local skill

# Run in the cloud against a repo
tessl launch skill workspace/my-skill --cloud --repo owner/repo --agent tessl-agent
tessl launch skill workspace/my-skill --cloud --repo owner/repo --no-wait

# Launch an agent directly
tessl launch claude-code
tessl launch tessl-agent

# Inspect cloud runs
tessl launch list
tessl launch view <run-id>
tessl launch logs <run-id>

Supported agents: claude-code, cursor, gemini, codex, openhands, openclaw, copilot, copilot-vscode, agents, tessl-agent.

Tessl Agent (built-in)

tessl agent                                    # interactive session
tessl agent --print "summarize recent changes" # one-shot
tessl agent --continue                         # resume last session
tessl agent --model anthropic/claude-opus-4-6
tessl agent --yolo                             # auto-approve all permissions
tessl agent --skill ./my-skill                 # load a specific skill

# MCP server management for the tessl agent
tessl agent mcp add my-server -- npx my-mcp-server
tessl agent mcp add my-server --url https://mcp.example.com --header "Authorization: Bearer token"
tessl agent mcp list
tessl agent mcp get my-server
tessl agent mcp remove my-server

Change Review (PR/diff gating)

# Risk assessment
tessl change risk                              # assess current diff
tessl change risk --fail-if-review-required    # CI gate
tessl change risk init --policy conservative-starter

# Code review
tessl change review --skill tessl/code-review#review-code-legibility
tessl change review --skill ./local-skill --base origin/develop

# Verify files against configured rules
tessl change verify
tessl change verify --dry-run --show-files
tessl change verify --group my-group --github   # emit GitHub annotations

Workspace Management

tessl workspace create myworkspace
tessl workspace list
tessl workspace delete myworkspace
tessl workspace add-member --workspace myws --username alice --role publisher
# Roles: member, publisher, manager, owner
tessl workspace remove-member --workspace myws --username alice
tessl workspace list-members myws
tessl workspace archive --reason "deprecated" myws
tessl workspace unarchive myws

Role ladder (least → most permission):

member — read/consume plugins
publisher — create, publish, unpublish (within 2 days)
manager — controls who holds publisher/manager
owner — full control

API Keys (for CI)

tessl api-key create --workspace myws --name "ci-key" --role publisher --expiry-date 2027-12-31T00:00:00Z
tessl api-key list --workspace myws
tessl api-key delete --workspace myws

Set the resulting token as TESSL_TOKEN in CI env vars — no tessl login needed.

Common Failures (launch/admin)

Error	Cause	Fix
`Not authorized` on publish	Role lacks permission	Ask a workspace manager to grant `publisher`
Cloud launch stalls	`--wait` default plus long-running task	Use `--no-wait` and check `tessl launch view <id>` later
API key rejected in CI	`TESSL_TOKEN` env var missing or expired	Regenerate via `tessl api-key create` and update CI secret
`tessl change verify` skips everything	No verifier files under configured group path	Check `verify` block in `tessl.json` and lint verifier JSON with `tessl change verify lint`

.tessl-plugin

skills

tessl-authoring

tessl-basics

tessl-evals

tessl-launch

SKILL.md

tile.json