selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Stoneforge logo

Self-host Stoneforge

v1.25.0

Orchestrate parallel AI coding agents with a live dashboard

BetaOpen SourceApache-2.0
Updated5 months ago
LanguageTypescript
Setup difficultyAdvanced
MobileResponsive
ThemeDark mode
Stars
196
Ports
3457 (smithy-server (agent orchestration API and web dashboard)), 3456 (quarry-server (core Stoneforge API server)), 5173 (quarry-web (element management dashboard)), 5174 (smithy-web (agent management dashboard))
Requires
Node.js
Install with NPM
Stoneforge screenshot 1Stoneforge screenshot 2Stoneforge screenshot 3Stoneforge screenshot 4

What is Stoneforge?

Stoneforge installs as a global npm package and runs locally in any project, providing a web dashboard at localhost:3457. It coordinates multiple AI agents — a Director that plans work, ephemeral Workers that execute tasks in isolated git worktrees, and Stewards that handle merge review. Key capabilities include dependency-aware task dispatch, automatic merge review with test execution, real-time agent communication via channels and threads, Linear-like issue tracking with kanban views, searchable document libraries with version history, and structured workflows that resume from failure points. It supports three major AI coding tools as underlying providers. Stoneforge uses a dual storage model with SQLite as a query cache and JSONL as the git-tracked source of truth. The project is early-stage and experimental, with high token consumption and autonomous agent execution by design.

Should you self-host Stoneforge?

Stoneforge scores 43/100 on selfhost.directory (how scoring works) and ranks #120 of 166 in Developer Tools. It has 196 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v1.25.0, came out on 5 May 2026. New versions land roughly every 2 days.

Setup is advanced: plan for several services and some ongoing maintenance. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Memos (86/100, 64 147 stars). It scores higher overall, so compare the two before you pick. See Stoneforge vs Memos side by side.

Features

  • Agent Pools
  • Automatic merge review
  • Custom prompts
  • Dependency-aware task dispatch
  • Event-sourced storage
  • Evergreen documentation
  • In-browser code editor
  • Linear-like issue tracking
  • Multi-Agent Orchestration
  • Multi-Provider Support
  • Real-time agent communication
  • Structured workflows
  • Task handoff
  • Web Dashboard
  • Worktree Isolation

Stoneforge README

How to install Stoneforge

Install Stoneforge with NPM

1. Install the Stoneforge CLI globally

npm install -g @stoneforge/smithy

2. Initialize a workspace in your project

cd your-project && sf init

3. Start the server + web dashboard at http://localhost:3457

sf serve

Requires Node.js 18+ or Bun

How to configure Stoneforge

  • auto-cleanupWhether merge steward auto-cleans up branches after merge

    Whether merge steward auto-cleans up branches after merge

    values: true, false

  • auto-pushWhether merge steward auto-pushes after merge

    Whether merge steward auto-pushes after merge

    values: true, false

  • director.mdCustom prompt for Director agent role

    Custom prompt for Director agent role

  • merge providerMerge provider: GitHub (PR-based) or local smithy (local merge requests)

    Merge provider: GitHub (PR-based) or local smithy (local merge requests)

    values: GitHub, local smithy

  • merge strategyMerge strategy used by merge steward (squash/merge)

    Merge strategy used by merge steward (squash/merge)

    values: squash, merge

  • persistent-worker.mdCustom prompt for Persistent Worker agent role

    Custom prompt for Persistent Worker agent role

  • pool size limitsConcurrent execution limits for agent pools

    Concurrent execution limits for agent pools

  • providerClaude CodeAI provider for agents: Claude Code, OpenCode, or OpenAI Codex

    AI provider for agents: Claude Code, OpenCode, or OpenAI Codex

    values: Claude Code, OpenCode, OpenAI Codex

  • steward-base.mdCustom prompt for base Steward agent role

    Custom prompt for base Steward agent role

  • steward-docs.mdCustom prompt for Docs Steward agent role

    Custom prompt for Docs Steward agent role

  • steward-merge.mdCustom prompt for Merge Steward agent role

    Custom prompt for Merge Steward agent role

  • steward-recovery.mdCustom prompt for Recovery Steward agent role

    Custom prompt for Recovery Steward agent role

  • test commandTest command run by merge steward before merging

    Test command run by merge steward before merging

  • worker.mdCustom prompt for Worker agent role

    Custom prompt for Worker agent role

Stoneforge releases & version history

More in Task Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…