LiteAgent

A lightweight, CLI-first Agent Harness framework built with TypeScript, React Ink, and Bun. Inspired by Claude Code architecture.

# Install globally via npm
~ ❯ npm install -g @sqfcy/liteagent
# Start (first run will guide you through setup)
~ ❯ la
# Developer logs (writes lite-agent-dev.log to current dir)
~ ❯ la --dev

# Or clone and run with Bun
~ ❯ git clone https://github.com/sqfcyily/LiteAgent.git
~ ❯ cd LiteAgent && bun install && bun start
View on GitHub

Core Architecture

Async Generator Engine

A pure REPL loop driven by asynchronous generators, flawlessly handling stream output, tool calls, and result concatenation without the overhead of heavy abstractions.

Virtual DOM CLI

Utilizes React Ink to bring modern web development paradigms to the terminal. Declarative UI, state management, and seamless stream handoffs.

Dynamic Skill Injection

Keep system prompts clean and focused. Inject expert workflows, contexts, and specific toolsets into the LLM strictly on-demand.

Invisible Fork Mode

Prevent context pollution. The agent forks invisible sub-processes to execute trial-and-error tasks, summarizing and merging only the final answers back to the main thread.