internbot

A minimal Slack bot for research labs (~1,650 lines of TypeScript). Routes messages through Haiku triage (cheap, fast) and escalates complex requests to an Opus agent running via the Claude Code SDK.

How It Works

Slack message → whitelist filter → store in SQLite → Haiku triage
  ├─ ignore   → done (no API cost)
  ├─ simple   → Haiku reply → send to Slack (~$0.001)
  └─ escalate → Agent (Claude Code SDK) → send to Slack

Two-layer triage:

1. Free string match — if the bot isn't mentioned in a channel, ignore with zero cost
2. Haiku API call — classifies into ignore/simple/escalate

Skills

Skill	Description
arxiv-search	Search and summarize arxiv papers
web-search	Search the web for recent information
research-brainstorm	Brainstorm follow-up research directions from papers
code-review	Explain and review code
latex-report	Write LaTeX research reports, publish to GitHub
daily-papers	Review HuggingFace daily papers, write a LaTeX summary of the top pick
manage-schedules	View, add, update, or cancel scheduled/recurring tasks
add-channel	Add a Slack channel to the bot's whitelist
onboard	Developer setup guide

MCP Servers

Server	Package	Description
arxiv	@langgpt/arxiv-paper-mcp	Search and fetch arxiv papers
context7	@upstash/context7-mcp	Library documentation lookup
time	@mcpcentral/mcp-time	Current time and timezone info
hf_papers	huggingface-daily-paper-mcp	HuggingFace daily papers feed

Setup

1. Create a Slack app with Socket Mode (see .claude/skills/onboard/SKILL.md for detailed steps)
2. Copy .env.example to .env and fill in your tokens
3. Install and run:

npm install
npm run dev    # Development with hot reload
npm run build  # Compile TypeScript
npm start      # Run compiled version

Configuration

All config is in .env:

Variable	Description	Default
SLACK_BOT_TOKEN	Slack bot OAuth token	(required)
SLACK_APP_TOKEN	Slack app-level token	(required)
ASSISTANT_NAME	Bot display name	internbot
WHITELISTED_CHANNELS	Comma-separated channel IDs	(all channels)

Project Structure

src/
  index.ts      # Orchestrator: Slack events → triage → agent → reply
  slack.ts      # @slack/bolt Socket Mode connection
  triage.ts     # Haiku triage (Claude Code SDK)
  agent.ts      # Agent (Claude Code SDK, runs in host process)
  config.ts     # .env config reader
  db.ts         # SQLite (messages + sessions)
  skills.ts     # Skill discovery for triage context
  env.ts        # .env parser
  logger.ts     # Pino logger
  types.ts      # TypeScript interfaces

Acknowledgements

This project is a fork of NanoClaw and inherits its skill-centric architecture. The triage agent design — using a lightweight model to classify and route messages before escalating to a full agent — is inspired by KIRA from the KRAFTON KIRA project.

License

MIT