iTermBot

iTermBot is an application built on the @easynet agent framework. It runs two agents:

1. ReAct agent — LangChain createAgent (ReAct pattern) with tools and memory.
2. Deep agent — DeepAgents createDeepAgent with a persistent store backed by agent-memory.

Both agents share:

• @easynet/agent-common — YAML config (app, paths).
• @easynet/agent-model — LLM and embedding models (falls back to module default config).
• @easynet/agent-memory — Agent memory (recall/inject for ReAct; store adapter for Deep).
• @easynet/agent-tool + @easynet/agent-tool-buildin — Tools (FS, HTTP, util, exec, git, analyze, iTerm, etc.).

Prerequisites

• Node.js >= 18
• Ollama (or another OpenAI-compatible endpoint) for the LLM. Default config uses http://localhost:11434/v1 and qwen3:0.6b.

Setup

Build from source workspace:

cd apps/itermbot
npm install
npm run build

Tool support uses agent-tool’s @easynet/agent-tool and @easynet/agent-tool-buildin from the npm registry.

Config

| File | Purpose | |------|--------| | config/app.yaml | App-level settings (agent, printSteps, prompt templates). |

Agent profile defaults (model/memory/tool/skills) are resolved by @easynet/agent-runtime. Top-level app config only overrides runtime defaults.

apps/itermbot/config/tool.yaml now loads the full built-in tool package and applies local policy overrides for higher-risk tools such as itermRunCommandInSession. This gives iTermBot direct access to local repository analysis and review primitives including fs.*, git.*, analyze.*, http.*, and iTerm tools.

apps/itermbot/skills/source-code-review adds a dedicated workflow for:

• source code analysis
• repository understanding
• PR / diff review
• bug and regression finding

Usage

• Interactive (ReAct agent):

  npm start
  # or
  npm run react

• Interactive (Deep agent):

  npm run deep

• One-shot query:

  node dist/index.js react "What time is it?"
  node dist/index.js deep "Remember I prefer short answers."

Scripts

| Script | Description | |--------|-------------| | npm run build | Compile TypeScript to dist/. | | npm start | Run interactive with ReAct agent. | | npm run react | Same as start (ReAct). | | npm run deep | Interactive with Deep agent. | | npm run typecheck | Type-check only. | | npm run test:llm | Test LLM config (scripts/test-llm.mjs). |

Architecture

• src/index.ts — CLI startup and orchestration.
• src/context.ts — Shared BotContext builders (LLM/memory/tools/skills).
• src/config.ts — App-level override adapter on top of runtime config.
• src/startup/ — startup UI, diagnostics, and panel color bootstrapping.
• src/iterm/ — iTerm session routing and target session prompt injection.

Both agents use the same LLM, memory backend, and tool set; only the orchestration (ReAct vs Deep) differs.