aistvagent
v1.0.5
Published
AI STV — remote compute runner for AISTV. Spawn GitHub Actions VMs with opencode + DeepSeek V4 Flash free, no API key needed.
Maintainers
Readme
aistvagent — AI STV Remote Compute Runner
Spawn disposable GitHub Actions VMs with opencode + DeepSeek V4 Flash, connected over Tailscale. Auto-recycles after 6 hours or 110,275 tokens.
Install
npm install -g aistvagentSetup
# In your AISTV project:
aistvagent init
# Set these env vars (or hardcode into the tool):
export GH_TOKEN=ghp_...
export TAILSCALE_AUTH_KEY=tskey-auth-...How it works
- Ask the AI: "Dùng AI STV runner"
- The AI calls the
ai-stv-runnertool → dispatches a GitHub Actions workflow - VM boots, joins Tailscale, installs
opencode+ DeepSeek V4 Flash - SSH into the VM and run
opencode(free, no API key needed) - After 6h / 110,275 tokens → VM auto-recycles, spawns a new one
Requirements
- GitHub account with Actions enabled
- Tailscale account (free tier)
- SSH server running on your machine (for the SSHFS mount)
Files installed
| File | Purpose |
|------|---------|
| .github/workflows/ai-stv-runner.yml | GitHub Actions workflow |
| .aistv/tool/ai-stv-runner.ts | AISTV tool definition |
| .aistv/instructions/ai-stv-runner.md | Instructions for the AI |
| .aistv/aistv.jsonc | Config with permission + tool enabled |
