gitwtfhub

wtf is taicode?

endymionlee/taicode — explained in plain English

Analysis updated 2026-05-18

102TypeScriptAudience · developerComplexity · 4/5LicenseSetup · easy

TL;DR

A learning project that builds a Claude Code style AI coding agent using LangGraph, with memory, tool use, parallel task execution, and terminal or web interfaces.

Mindmap

mindmap
  root((taicode))
    What it does
      AI coding agent
      Built with LangGraph
      Terminal and web UI
    Tech stack
      TypeScript
      LangGraph LangChain
      React Ink Fastify
    Use cases
      Study agent architecture
      Run local coding assistant
      Explore parallel task planning
    Audience
      Developers learning agents
    Setup
      npm install global
      Run in terminal
      Run with web flag

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

Study how a Claude Code style AI coding agent can be built from scratch with LangGraph.

REASON 2

Run an AI coding assistant locally from the terminal or a web browser interface.

REASON 3

Learn how task planning, dependency graphs, and parallel workers can speed up complex AI agent tasks.

REASON 4

Explore how local embeddings can power an agent's memory and skill retrieval without external services.

What's in the stack?

TypeScriptNode.jsLangGraphLangChainReactFastify

How it stacks up

endymionlee/taicodeherry2059/project-os-for-codexjazzband/web3-devkit-cli
Stars102101101
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity4/54/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Installs as a global npm package, needs an LLM API key configured through the OpenAI SDK to actually run tasks.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

Wtf does this do

TAICode is a learning project that builds an AI coding agent modeled after tools like Claude Code. It is built on LangGraph, a framework for building AI agents as state machines, combined with a reasoning approach called ReAct and task graphs that let work run in parallel. The project supports memory across sessions, the Model Context Protocol for connecting external tools, reusable skills, coordination between multiple agents, and both a terminal interface and a web interface. When a user sends a request, a routing layer decides whether it is simple enough for a single worker to handle directly or complex enough to go through a planner. The planner first inspects the project using tools like listing files, reading files, and searching text, then breaks the task into a dependency graph so that up to eight workers can execute pieces of it at the same time once their dependencies are satisfied. A separate context compiler continuously scores and trims the information being sent to the model so that long tasks do not overwhelm it with stale or low-value context. Memory is organized into four layers: short-term memory, semantic memory, a user profile, and stored rules, all converted into vector representations locally using a small embedding model so nothing needs to be sent to an external service just to search memory. Skills work similarly, with markdown files scanned from a local folder, converted to embeddings, and automatically matched to relevant tasks using similarity search, so a long list of instructions does not need to be pasted into every prompt by hand. Built-in tools cover common file and shell operations such as reading, writing, copying, moving, and deleting files, plus running shell commands, each command run as its own process and classified into three permission levels: automatically allowed, requiring user confirmation, or blocked outright. The project is written in TypeScript and Node.js, using LangGraph and LangChain for the agent logic, React and Ink for the terminal interface, and Fastify with WebSockets for the web interface. It is installed as a global npm package and can be run from the terminal or launched with a web flag to open a local browser interface. The project is licensed under the Apache License 2.0.

Yoink these prompts

Prompt 1
Help me install and run TAICode from the terminal and then try the web interface.
Prompt 2
Explain how TAICode's Gate and Planner routing decides between simple and complex tasks.
Prompt 3
Walk me through how TAICode's four-layer memory system and local embeddings work.
Prompt 4
Show me how skills are stored, embedded, and matched to tasks in this project.
Prompt 5
Explain the three permission levels TAICode uses for shell and file tool commands.

Frequently asked questions

wtf is taicode?

A learning project that builds a Claude Code style AI coding agent using LangGraph, with memory, tool use, parallel task execution, and terminal or web interfaces.

What language is taicode written in?

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

What license does taicode use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is taicode to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is taicode for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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