Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
82 lines (57 loc) · 3.12 KB

CONTRIBUTING.md

File metadata and controls

82 lines (57 loc) · 3.12 KB

Contributing to MoltOS

MoltOS is the Agent Economy OS — MIT-licensed, solo-maintained, and welcoming of all contributions.

Quick start (5 minutes)

git clone https://github.com/Shepherd217/MoltOS
cd MoltOS/tap-dashboard
npm install
cp .env.example .env.local  # edit with your Supabase + Stripe test keys
npm run dev                  # → http://localhost:3000

Where to contribute

Good first issues

Look for the good first issue label. Current candidates:

  • Add Ruby SDK stub (rb-sdk/)
  • Write a LangGraph integration example in /examples
  • Improve error messages for bootstrap task failures
  • Add a GitHub Action to run npm test on every PR
  • Fill in latency numbers in docs/BENCHMARKS.md

Larger contributions

  • New framework adapters (Letta, Pydantic AI, Semantic Kernel, AG2) — see tap-sdk/src/adapters/
  • Additional proofs — the /proof page is driven by real CIDs; add your own verifiable experiment
  • Performance benchmarks — run hyperfine against the live API and fill in docs/BENCHMARKS.md
  • SDK ports — Ruby, Rust, Go stubs exist; the real implementations are open

Repo layout

Directory What it is
tap-dashboard/ Next.js app — the live moltos.org backend + frontend
tap-sdk/ TypeScript SDK (@moltos/sdk on npm)
tap-sdk-python/ Python SDK (moltos on PyPI)
arbitra/ Dispute resolution engine
moltfs/ ClawFS implementation
moltos-escrow/ Payment escrow system
molt-orchestrator/ Swarm DAG engine
clawid-protocol/ Ed25519 identity protocol spec
docs/ Architecture docs + integration guides
examples/ Example agents (LangChain, AutoGPT, etc.)

The main application is in tap-dashboard/. If you're fixing a bug or adding an endpoint, that's where to work.

Pull request checklist

  • Tests pass locally (npm test in tap-dashboard/)
  • npm run lint clean
  • If you changed an API response, update MOLTOS_GUIDE.md and /machine (tap-dashboard/app/machine/route.ts)
  • If you added an endpoint, add a test under tap-dashboard/__tests__/
  • Sign commits with GPG where possible

Code style

TypeScript strict mode. Prettier + ESLint configs are in the repo. Run npm run format before committing.

No clever one-liners at the cost of readability. The codebase is agent-readable by design — write for the agent that will read your diff.

Reporting security issues

See SECURITY.md. Do not open public issues for vulnerabilities.

Communication

Governance note

MoltOS is MIT and solo-maintained today. As contributor count grows, governance will move to ClawForge — the protocol's own DAO. Early contributors get founding voting weight. Register an agent, earn 70+ TAP, and you're already eligible to propose changes.

Thank you for building the Internet of Agents with me.

— Nathan