gitwtfhub

wtf is agentkindergarten?

rokrak1/agentkindergarten — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · vibe coderComplexity · 3/5Setup · moderate

TL;DR

A self-hosted relay that mirrors your AI coding agent terminal sessions and their dev servers live to your phone or browser.

Mindmap

mindmap
  root((repo))
    What it does
      Mirror agent sessions live
      Auto-detect dev servers
      Push alerts on stalls
    Tech stack
      TypeScript
      Node.js CLI
      WebSockets relay
    Use cases
      Monitor Claude Code remotely
      View dev server from phone
      Grade agent progress
    Audience
      Vibe coders
      Remote developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Keep an eye on a long-running Claude Code or Codex session from your phone while away from your desk.

REASON 2

Open a dev server your agent started, like localhost:3000, live from your phone through the tunnel.

REASON 3

Get a push notification when an agent session stalls or hits a permission prompt.

REASON 4

Detach from a terminal session and reattach later from a different device.

What's in the stack?

TypeScriptNode.jsWebSocket

How it stacks up

rokrak1/agentkindergarten4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencevibe codervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires self-hosting a relay server (a VPS) in addition to installing the daemon CLI.

License is not stated in the README shown.

Wtf does this do

AgentKindergarten lets you watch and control your AI coding agent sessions, like Claude Code or Codex, from your phone or any browser while they keep running on your home computer. The idea is that these agents can work for a long time on their own, so you can step away from your desk, go to a family event, or run an errand, and still check in, type commands, or see what the agent is doing through a live terminal on your phone. It works with two small pieces. A daemon runs on your development machine and connects outward to a relay server you host yourself, so there is no need to open any ports or forward traffic into your home network. The relay just authenticates you and passes traffic through, storing nothing and keeping no logs of your sessions. Your agent login and API keys never leave your own machine, since the daemon simply runs the same command line tools you already have installed and signed in. Everything is driven through one command line tool called agk. After a one time setup that connects your machine to your relay, you start an agent session by typing agk claude instead of the usual claude command. That single session is then visible at the same time in your terminal, in a browser dashboard, and on your phone, so you can start it at your desk and keep watching it from anywhere without forking a separate session. You can detach from a session without stopping it, list every session currently running, rename them, stop them, or reattach later, tmux style. A few extra features round it out. Dev servers your agent starts, such as one on localhost:3000, are automatically detected and can be opened live through the tunnel from your phone. An optional feature called the teacher can grade each agent session's progress using your own claude CLI, another agent CLI, or an OpenRouter key. Another optional watcher sends a push notification to your phone if a session stalls, errors out, or is waiting at a permission prompt. The project is written in TypeScript and installed globally with npm.

Yoink these prompts

Prompt 1
Set up AgentKindergarten: install agentkindergarten with npm, run agk init with my relay URL and token, then start the daemon.
Prompt 2
Explain how to run agk claude instead of claude so my session mirrors to my phone and browser.
Prompt 3
Show me how to detach from an AgentKindergarten session with Ctrl+] and reattach later with agk attach.
Prompt 4
Set up the agk teacher feature to grade my agent's progress using my own claude CLI.
Prompt 5
Configure agk watch to send me a push alert if my agent session stalls or hits a permission prompt.

Frequently asked questions

wtf is agentkindergarten?

A self-hosted relay that mirrors your AI coding agent terminal sessions and their dev servers live to your phone or browser.

What language is agentkindergarten written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, WebSocket.

What license does agentkindergarten use?

License is not stated in the README shown.

How hard is agentkindergarten to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is agentkindergarten for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.