spectackl
Command-line interface to the Spectackl Public REST API — built for AI agents and operators who need programmatic access to artifacts, scenes and task executions without going through the web UI.
pip install spectackl
Quick start
spectackl init --api-key spc_… --backend-url https://api.spectackl.ai --project my-project
spectackl artifact list --json
API keys are managed in the Spectackl Admin Console. init writes
.spectackl/settings.yaml in the current directory and a user-global
~/.config/spectackl/settings.yaml; both are created 0600 and neither should be
committed.
What it does
| Command | Purpose |
|---|---|
spectackl search <query> |
Hybrid full-text + semantic search across a project's content |
spectackl artifact |
Get, list, create and update artifacts |
spectackl relation |
Manage the artifact graph (INCLUDES, DOCUMENTS, DEPENDS_ON, …) |
spectackl context |
Inspect scenes (work contexts) and the artifacts they scope |
spectackl task |
Claim, progress and complete task executions |
spectackl assets sync |
Materialize the project's agents and skills into ./.claude/ |
spectackl rsync |
Reconcile artifact content with local files, in both directions |
spectackl daemon |
Run agent sessions on this machine |
Every command accepts --json for machine-readable output, and every command returns a
documented exit code — 0 success, 10 auth required, 20 validation, 30 not found,
40 upstream unavailable, and so on — so scripts can branch on failures precisely
rather than parsing text.
Designed for agents
Output is stable and parseable, errors are structured, and the exit-code scheme is part
of the public contract. spectackl assets sync writes agent and skill definitions in the
exact layout Claude Code reads, built from the same artifacts the platform provisions
into a sandbox — so an agent invoked on a workstation is the one that runs in production.
Requirements
- Python 3.10+
- A Spectackl tenant and an API key (
spc_prefix)
Documentation
Full guide: https://docs.spectackl.ai
License
MIT
1 maintainer
Release files for spectackl 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| spectackl-1.2.0.tar.gz | 115.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| spectackl-1.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 210.1 kB
Release files / spectackl-1.2.0.tar.gz
| Download URL | spectackl-1.2.0.tar.gz |
|---|---|
| Size | 115.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ea84dd67a9c4cddef9667bda056d9d3cdeb0aa00c022d51d0040006966b5e36e
|
|
BLAKE2b-256 checksum How to use checksums |
4006457ed157f5b36069a2334c24d8291619d0542a8eff99c51b9779c9117c50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
Release files / spectackl-1.2.0-py3-none-any.whl
| Download URL | spectackl-1.2.0-py3-none-any.whl |
|---|---|
| Size | 94.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f0ce4901567b4a2a3840833b628441f245f23f8ce7e4ae9b2ef15cdd7cdf0d12
|
|
BLAKE2b-256 checksum How to use checksums |
72ccd5698bc454ea1679bd9f86a64e45cd93c6b308e25c58f7a9fb753fa03179
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.14
|
