tinycode

Three ways to start

Single binary for local dev. Container for teams. Operator for platform engineering.

Install, run, build something

Four workflows that show what tinycode does in practice. Copy-paste these into your terminal after installing.

Debug a failing test

$ tinycode /path/to/project

# In the TUI, type:
The test in auth_test.go is failing with "token expired."
Find the root cause and fix it.

# Or use the debug skill directly:
/debug auth_test.go is failing with "token expired"

Plan a feature before writing code

# Switch to plan mode — read-only, safe to explore
$ tinycode /path/to/project

# Press Tab to switch to the plan agent, then:
Add a /health endpoint that returns pod name,
uptime, and connected LLM providers.

# tinycode writes a plan to .tinycode/plans/
# Review it, approve, switch to build mode to execute

Review a pull request

$ tinycode /path/to/project

# Ask the code-reviewer agent:
/ask code-reviewer Review the diff on the current branch
against main. Focus on correctness and security.

Explore an unfamiliar codebase

$ tinycode /path/to/new-project

# Ask the architect agent:
/ask architect How is authentication handled in this project?
Trace from the HTTP handler to the token validation.

Embedded web interface

SolidJS web UI embedded in the binary via go:embed. Same conversation, agent, and tool capabilities as the TUI, served from the built-in HTTP server.

$ tinycode serve    # headless REST + SSE API server
$ tinycode web      # server + web UI

• Non-interactive mode — tinycode run <prompt> runs a prompt and exits, for scripts and CI.
• System prompt override — --append-system-prompt and --append-system-prompt-file inject custom instructions.
• External editor — /editor opens $EDITOR; /editor @file edits a file directly.
• Interactive shell — /shell drops into a shell session.

20 agents, 7 skills, 36 plugins

Tab cycles build, general, ops, plan, architect, code-reviewer. Models at 14B and under receive compact prompts. Plugins are standalone Go binaries over JSON-RPC.

Built-in agents

Skills & slash commands

Slash commands like /debug, /review, /trace, /plan, /verify, and /test invoke the matching agent. Bundled skills provide checklists and workflows.

• /incident — incident response checklist for the ops agent
• /change — change management workflow for the ops agent
• /host — host administration checklist for the ops agent
• /doctor — diagnose tinycode configuration and environment issues
• /mcp-setup — configure MCP servers via guided menu
• /remember — triage session findings across memory surfaces
• /deepinit — generate per-directory AGENTS.md files across a codebase

Plugins

36 built-in plugins ship as standalone Go binaries. Build custom plugins with the Go SDK in pkg/plugin/. See docs/plugin-development.md.

• General — log-sanitizer, safety-net, code-review, command-inject, context-pruning, handoff, notify, pilot, snippets, telemetry, web-search, cluster-ops
• OpenShift — ocp-oauth, ocp-context-injection, ocp-obs-metrics, ocp-obs-logging
• Ansible — aap-bridge, eda-events
• RHOAI — rhoai-serving, rhoai-pipelines, rhoai-mlflow, rhoai-experiment-tracker, rhoai-eval-trustyai, rhoai-mcp-bridge
• Platform — satellite, quay, rhdh, tekton, rhacm, rhacs, rh-api-catalog, rh-dev-content, rh-ecosystem-catalog, rhdp-provisioner, container-linter, lightwell

tinycode-operator

github.com/bobbyjohnstx/tinycode-operator

Kubernetes Operator for OpenShift. Manages TinycodeInstance custom resources with Helm-based reconciliation. Handles Routes, PVCs, SCCs, vLLM auto-probing, and pod lifecycle.

Install the operator

$ git clone https://github.com/bobbyjohnstx/tinycode-operator
$ cd tinycode-operator
$ make push IMAGE_ORG=yourorg IMAGE_TAG=v0.1.0
$ make install OPERATOR_IMAGE=quay.io/yourorg/operator:v0.1.0

Prepare a namespace

$ oc new-project tinycode-dev
$ oc create rolebinding tinycode-operator-admin \
  --clusterrole=admin \
  --serviceaccount=tinycode-operator-system:tinycode-operator-manager \
  -n tinycode-dev
$ oc create secret generic tinycode-password \
  --from-literal=TINYCODE_SERVER_PASSWORD=mysecretpass \
  -n tinycode-dev

Create a TinycodeInstance

apiVersion: tinycode.dev/v1alpha1
kind: TinycodeInstance
metadata:
  name: my-tinycode
spec:
  vllm:
    - name: vllm-qwen3
      url: http://qwen3-30b.qwen3.svc.cluster.local:8080
  model: "vllm-qwen3/qwen3-30b"
  auth:
    passwordSecret: tinycode-password
  storage:
    projectsSize: "20Gi"

Security contexts

• tinycode-restricted — default. Non-root (UID 1001), all capabilities dropped.
• tinycode-hostpath — when spec.storage.hostPath is set. Requires cluster-admin approval.
• tinycode-shell — when spec.shell.enabled: true. Adds hostPID + SYS_PTRACE. Requires review.

Additional capabilities

• Cross-namespace vLLM discovery — annotate model services with tinycode.dev/discover=vllm, list namespaces in spec.discovery.namespaces.
• GitOps mode — spec.git.url clones a repo into /projects with optional credentials and auto-pull.
• Cluster-admin mode — spec.clusterAdmin.enabled mounts kubeconfig and downloads oc CLI.
• Self-service provisioning — users create their own TinycodeInstance CRs in prepared namespaces. Instance-per-user isolation with no collisions.
• Vanilla Kubernetes — deploy without the operator using Kustomize manifests from tinycode-container, or Tekton + Argo CD for CI/CD.