$ _

your personal
AI agent

joshbot is a lightweight, self-learning AI assistant that lives in your terminal. Memory, skills, tool use, Telegram — everything you need, nothing you don't.

Install Now How It Works
joshbot — interactive session
$ joshbot agent
> what was that article about Go concurrency patterns?
[memory_search] Found 3 relevant facts...
You asked about this on March 12th. Key patterns: goroutines (cheap threads), channels (communicate via shared memory), and select (multiplex). Want me to fetch the full article?
>

ReAct loop,
real results

joshbot uses a ReAct (Reasoning + Acting) loop — it thinks, uses tools, learns from results, and iterates — all within a single conversation.

01

You speak

Send a message via CLI, Telegram, or script. Every channel feeds into a common message bus.

02

It reasons

The LLM core analyzes your intent with full context — past conversations, stored memories, available skills and tools.

03

It acts

Runs tools (search files, fetch web pages, execute code, delegate subagents) and observes results.

04

It learns

Key facts are extracted and saved to long-term memory. Repeated tool patterns auto-create reusable skills.

14,500
Lines of Go
46
Test Files
520+
Test Functions
20
Built-in Tools

What can it do?

From daily productivity to deep research — joshbot handles the spectrum.

Daily Briefing

Summarizes calendar, tasks, and priorities into a morning plan. Flag urgent items and draft replies.

🔬

Deep Research

Gathers information across multiple sources, cross-references, and returns a structured brief with citations.

🧠

Cross-Session Memory

Retains facts, preferences, and decisions across days. Retrieves relevant context without being reminded.

🛠️

Code & Engineering

Generates, explains, debugs, and refactors code. Runs lint/tests on results. Investigates bugs systematically.

📡

Workflow Automation

React to triggers (new file, webhook, cron) to run pipelines: fetch → transform → notify → archive.

🧩

Auto Skill Creation

Observes repeated tool-use patterns and generates reusable skills. Common tasks become one-command operations.

🤖

Subagent Delegation

Fans out independent tasks to parallel subagents or chains steps sequentially. Each gets focused context.

📱

Telegram Integration

Chat from anywhere via Telegram. Full skill and memory access from your phone. Long-polling, no webhooks needed.

Get Started

One command to install

Open source, MIT licensed. Your data stays on your machine.

curl -fsSL https://raw.githubusercontent.com/bigknoxy/joshbot/main/install.sh | bash