Manage and track autonomous AI research projects with state logging, instruction queues, agent coordination, and progress monitoring via SQLite.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
CLI tool for managing autonomous research agents with append-only state, instruction queues, and oversight.
brew tap 1645labs/tap brew install julians-research-tracker
Or:
go install github.com/1645labs/julians-research-tracker/cmd/research@latestresearch init market-q1 --name "Q1 Market Analysis" --objective "Analyze competitor pricing and positioning"
export RESEARCH_SESSION_ID="$SESSION_KEY" # Track which agent is writingresearch log market-q1 STEP_BEGIN --step 1 --payload '{"task":"gather sources"}'
... do work ...
research log market-q1 STEP_COMPLETE --step 1 research heartbeat market-q1
research status market-q1 --json research context market-q1 --last 5 # Truncated context for prompts
research instruct market-q1 "Focus on enterprise segment" --priority URGENT research stop-signal market-q1 # Request graceful stop
research pending market-q1 --json research ack market-q1 --all # Acknowledge after processing research check-stop market-q1 # Exit 0 = stop, Exit 1 = continue
| Command | Purpose |
|---|---|
| Create project with objective |
| List projects (includes |
| Project details + recent events |
| Stop project, send STOP instruction |
| Archive completed project |
| Log event (STEP_BEGIN, CHECKPOINT, BLOCKED, etc.) |
| Update alive timestamp |
| Mark blocked, needs input |
| Mark done |
| Current state summary |
| Truncated context for agent prompts |
| Send instruction |
| List unacked instructions |
| Acknowledge instructions |
| Exit code: 0=stop, 1=continue |
| Log audit result |
STARTEDSTEP_BEGINSTEP_COMPLETECHECKPOINTBLOCKEDUNBLOCKEDAUDIT_PASSAUDIT_DRIFTHEARTBEATDONESTOPPEDTIMEOUT1. research init <project> --objective "..." 2. sessions_spawn with task including: - Project ID and objective - Instructions to use research CLI for state - Check stop signal before each step - Log progress with heartbeat 3. Heartbeat monitors: research list --json | check needs_attention 4. Send instructions via: research instruct <project> "..."
while research check-stop $PROJECT; [ $? -eq 1 ]; do research pending $PROJECT --json # Check instructions research log $PROJECT STEP_BEGIN --step $STEP # ... do work ... research log $PROJECT STEP_COMPLETE --step $STEP research heartbeat $PROJECT STEP=$((STEP + 1)) done research complete $PROJECT
research list --jsonneeds_attention: trueSQLite at
~/.config/research-tracker/research.dbRun
research db migrateNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.