Open Source · Self-Hosted · Autonomous

Meet ForkScout

Runs shell commands

An autonomous AI agent that runs shell commands, browses the web, reads and writes files, remembers everything, and modifies its own code. Not a chatbot wrapper — a real agent.

curl -fsSL https://raw.githubusercontent.com/marsnext/forkscout/main/install.sh | bash
forkscout — zsh
live
0Channels
0+Tools
0LLM Providers
0MCP Servers
0msAvg Response
0%Self-Hosted

Built With

The modern stack powering ForkScout

Bun

Blazing-fast JS runtime with native TS, built-in bundler, and 3× faster installs.

TypeScript

Strict mode catches bugs at compile time. Every tool and provider is fully typed.

Vercel AI SDK v6

Unified interface for 9+ LLM providers with streaming and multi-step agent loops.

MCP Protocol

Add capabilities by dropping a JSON config file. Zero code changes required.

SearXNG

Self-hosted meta search. No API keys, no rate limits, fully private web search.

LevelDB

Embedded key-value store for persistent memory. Zero config, survives restarts.

Docker

One command to deploy anywhere. Compose stack for agent, search, and memory.

Zod

Runtime schema validation for every tool input. Catches bad LLM params early.

Node.js

Battle-tested ecosystem with native child_process for real shell access.

Turbopack

Next.js incremental bundler with near-instant HMR. Reloads in milliseconds.

Bun

Blazing-fast JS runtime with native TS, built-in bundler, and 3× faster installs.

TypeScript

Strict mode catches bugs at compile time. Every tool and provider is fully typed.

Vercel AI SDK v6

Unified interface for 9+ LLM providers with streaming and multi-step agent loops.

MCP Protocol

Add capabilities by dropping a JSON config file. Zero code changes required.

SearXNG

Self-hosted meta search. No API keys, no rate limits, fully private web search.

LevelDB

Embedded key-value store for persistent memory. Zero config, survives restarts.

Docker

One command to deploy anywhere. Compose stack for agent, search, and memory.

Zod

Runtime schema validation for every tool input. Catches bad LLM params early.

Node.js

Battle-tested ecosystem with native child_process for real shell access.

Turbopack

Next.js incremental bundler with near-instant HMR. Reloads in milliseconds.

Capabilities

Built for real autonomy

Every capability is a callable tool — not generated text.

Real Shell Access

Execute any command, install packages, manage servers — not a sandbox.

Persistent Memory

Remembers facts, decisions, and conversations across restarts.

MCP-First

Add capabilities via JSON config. Drop a file, tool is live.

Provider-Agnostic

Swap between 9 LLM providers by changing one JSON field.

Self-Modifying

Edits its own source, typechecks, and restarts itself.

Multi-Channel

Same agent brain on Telegram, terminal, WhatsApp, and web.

Web Search & Browse

Self-hosted SearXNG search and full webpage content extraction.

File Read & Write

Reads files in chunks, writes with directory creation.

Task Orchestration

Parallel workers, sequential chains, live progress — all autonomous.

Multi-Channel

20 channels. One agent brain.

Same adapter pattern everywhere — raw JSON in, agent reply out. Set env vars and it auto-starts.

Telegram

Core

Full-featured bot with auth, queuing, rate limiting & owner commands

WhatsApp

Core

Baileys Web WS protocol, QR pairing, media & image analysis

Terminal

Core

Interactive CLI with live token streaming — same agent brain

Self (HTTP)

Core

REST API for self-sessions, cron jobs, and external triggers

Discord

Gateway

Gateway WebSocket — guilds, DMs, MESSAGE_CONTENT intent

Slack

Gateway

@slack/bolt Socket Mode — no public URL needed

Matrix

Gateway

matrix-bot-sdk with autojoin — federated, self-hosted chat

WebChat

Gateway

Bun native WebSocket on /ws — zero external deps

Email

Gateway

IMAP polling + SMTP reply — works with any email provider

Teams

Webhook

Microsoft Bot Framework — works with Teams & Outlook

Google Chat

Webhook

Google Workspace API — service account auth

LINE

Webhook

LINE Messaging API — group chats & 1:1

Viber

Webhook

Viber Bot API — direct REST, auto webhook registration

Messenger

Webhook

Facebook Messenger Platform — webhook verification built-in

Instagram

Webhook

Instagram Graph API — DMs via webhook

SMS

Webhook

Twilio Programmable Messaging — reach any phone number

Voice Call

Webhook

Twilio Voice — STT input, TTS spoken reply, multi-turn

Twitter / X

Polling

X API v2 — DM polling with conversation threading

Reddit

Polling

snoowrap — inbox DMs, mentions & comment replies

YouTube Live

Polling

Data API v3 — live stream chat with API-set poll interval

Each channel is ~60-80 lines of code. All share the same adapter —createChannelHandler()

Use Cases

What can you build with it?

From DevOps to research — one agent, infinite workflows.

Infrastructure

DevOps Automation

Automate deployments, monitor servers, and handle incident response — 24/7 without human intervention.

Engineering

Code Review & Refactor

Analyze pull requests, suggest improvements, refactor legacy code, and enforce coding standards autonomously.

Knowledge

Research & Analysis

Search the web, read documents, synthesize findings, and deliver structured reports on any topic.

Security

Security Auditing

Scan codebases for vulnerabilities, review dependencies, and generate security compliance reports.

Automation

CI/CD Pipelines

Orchestrate build, test, and deploy workflows. Auto-fix failing tests and notify across channels.

Communication

Multi-Channel Support

Answer questions on Telegram, WhatsApp, and web simultaneously with shared context and memory.

Provider Agnostic

9 LLM providers. One JSON field.

Swap providers and model tiers without touching code.

OpenRouter logoOpenRouterAnthropic logoAnthropicGoogle logoGooglexAI logoxAIDeepSeek logoDeepSeekPerplexity logoPerplexityReplicate logoReplicateHuggingFace logoHuggingFaceElevenLabs logoElevenLabs
forkscout.config.json
1234567
// Switch model — no code changes
{
"llm": {
"provider": "openrouter",
"tier": "balanced"
}
}

Ready to deploy your own agent?

One command to install. Self-hosted. Full control. No vendor lock-in.