Turn terminal input into local, inspectable HTML artifacts.
Getting Started · Studio · Download · FAQ
t2w is a Rust CLI and local browser Studio for turning prompts, logs, tables, notes, and stdin payloads into self-contained HTML pages. It streams output into a live preview, wraps finished HTML in an artifact shell, and keeps the default path local and token-free.
| Artifact Shell | Studio |
|---|---|
 |
 |
- Local by default: the
mockprovider is the default, so smoke tests and Studio checks need no key and spend no tokens. - Live HTML preview: generated chunks stream into the browser while a run is still active.
- Studio workspace: manage sessions, templates, skills, run state, cancellation, source view, and downloads.
- Persistent runs: Studio stores sessions and completed run history under
.t2w/studio-state.json. - Reinforcement Formula: Prompt, Data, Theme, and Run stages are rendered locally in Studio and artifact shells.
- Skill-aware prompting: select local
SKILL.mdfiles explicitly or discover them from configured roots. - Portable releases: release archives contain both binaries, README files, license, and bundled assets.
Run the CLI from source:
cargo run -p agent-cli --bin t2w -- --provider mock --no-open "build a clean operations dashboard as HTML"Start Studio:
cargo run -p agent-cli --bin t2w-studio -- --port 3000Open http://127.0.0.1:3000/.
Install both binaries locally:
cargo install --path crates/agent-cli --bin t2w --bin t2w-studio --forceCreate an artifact from a plain instruction:
t2w --provider mock --no-open "build a compact release checklist as HTML"Pipe data into the instruction:
Get-Content .\access.log | t2w "build an incident dashboard from these logs"Use a local skill:
t2w --skill log-dashboard "build a dashboard from these logs"Common options:
t2w "<instruction>"
--provider anthropic|mock
--skill <name>
--skills-dir <path>
--config <path>
--artifacts-dir <path>
--no-open
--no-snapshot
Snapshots are written to .t2w/artifacts/ unless --no-snapshot is used.
Studio is served locally by t2w-studio; it does not require a frontend build or hosted service.
t2w-studio --port 3000Options:
t2w-studio
--host <host>
--port <port>
--skills-dir <path>
--config <path>
--artifacts-dir <path>
--sessions-file <path>
Default state and output paths:
| Path | Purpose |
|---|---|
.t2w/studio-state.json |
Studio sessions and run history. |
.t2w/artifacts/ |
CLI and Studio snapshots. |
If the Studio state file is corrupt, t2w preserves the bad file as .corrupt and starts with an empty state.
mock is the default provider. It is deterministic, local, and does not call a model.
Anthropic generation is opt-in. Set the enable flag and key, then choose the Anthropic provider:
$env:T2W_ENABLE_ANTHROPIC = "1"
$env:T2W_ANTHROPIC_API_KEY = "your-key"
$env:T2W_ANTHROPIC_MODEL = "claude-sonnet-4-5"
t2w --provider anthropic "build a clean operations dashboard as HTML"Equivalent config file:
anthropic_enabled = true
anthropic_api_key = "your-key"
anthropic_model = "claude-sonnet-4-5"
mock_chunk_delay_ms = 0Environment variables:
| Name | Purpose |
|---|---|
T2W_ARTIFACTS_DIR |
Override snapshot output directory. |
T2W_ENABLE_ANTHROPIC |
Enable Anthropic when set to 1, true, yes, or on. |
T2W_ANTHROPIC_ENABLED |
Alternate Anthropic enable flag. |
T2W_ANTHROPIC_API_KEY |
Anthropic API key. |
T2W_ANTHROPIC_MODEL |
Anthropic model name. |
T2W_MOCK_CHUNK_DELAY_MS |
Delay mock chunks for streaming tests. |
Only provider calls spend tokens. Mock runs, Studio rendering, previews, snapshots, and Reinforcement Formula display are local.
t2w discovers local SKILL.md files from:
./skills./.t2w/skills- extra directories passed with
--skills-dir
Example skill: examples/skills/log-dashboard/SKILL.md
The release workflow builds portable archives for:
| System | Architecture | Package |
|---|---|---|
| Windows | x86_64 | .zip |
| macOS | Apple Silicon / aarch64 | .tar.gz |
| macOS | Intel / x86_64 | .tar.gz |
| Linux | x86_64 | .tar.gz |
t2w does not ship native .msi, .pkg, .deb, or AppImage installers yet. Current releases are portable archives.
Download the latest portable archive from GitHub Releases.
| Platform | Package |
|---|---|
| Windows x64 | t2w-windows-x86_64.zip |
| macOS Apple Silicon | t2w-macos-aarch64.tar.gz |
| macOS Intel | t2w-macos-x86_64.tar.gz |
| Linux x64 | t2w-linux-x86_64.tar.gz |
Each release includes matching .sha256 checksum files.
Windows:
Expand-Archive .\t2w-windows-x86_64.zip -DestinationPath .
cd .\t2w-windows-x86_64
.\t2w.exe --provider mock --no-open "build a clean operations dashboard as HTML"
.\t2w-studio.exe --port 3000macOS / Linux:
tar -xzf t2w-linux-x86_64.tar.gz
cd t2w-linux-x86_64
chmod +x t2w t2w-studio
./t2w --provider mock --no-open "build a clean operations dashboard as HTML"
./t2w-studio --port 3000cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo build --releaseRelease packages are built by .github/workflows/release.yml:
git tag v0.1.0
git push origin v0.1.0No. The default mock provider is local and deterministic.
Only when you explicitly enable Anthropic and select the anthropic provider.
No. It is rendered locally in Studio and artifact shells unless a future change explicitly wires it into provider prompting.
t2w-studio is the local browser Studio binary. Smoke tests start it to verify the app shell, API, streaming preview, and artifact routes without requiring a model key.
Snapshots go to .t2w/artifacts/ by default. Studio state goes to .t2w/studio-state.json.
- Stabilize the CLI, Studio API, artifact shell, and release archive contract.
- Expand Reinforcement Formula presets for logs, tables, dashboards, reports, and inspectors.
- Add more providers and model presets while keeping the local-first default.
- Add installable skill packs and stronger sandbox boundaries.
- Build a real TUI surface next to the browser Studio.
Email: capwitf@outlook.com
MIT. See LICENSE.
