Skip to content

Lucineer/capitaine

Repository files navigation

Capitaine · The Flagship of the Lucineer Fleet

A git-native repo‑agent: the repository is the agent.
Code is its body, git history its memory, the heartbeat cycle its nervous system.


⚓ First Contact

Welcome to the announcement point for the Lucineer fleet.
This is where you meet the idea—in the first 30 seconds you should understand what we’re building and why you might care.

🧠 The Core Idea: Superinstances

A Superinstance is a persistent, autonomous software entity that lives in a git repository.
It thinks, acts, and evolves through a continuous heartbeat cycle, treating the repo as its own state.

  • It’s not a chatbot with git installed — the repo is the agent.
  • It’s not a CI/CD pipeline — it has intent, memory, and can initiate change.
  • It’s not a static codebase — it improves itself, writes its own docs, and coordinates with other vessels.

Think of it as a marine vessel: hull, captain, helm, fleet—but made of commits and issues.


🗺️ Explore the Fleet

Vessel Class Purpose Port
Capitaine (you are here) Flagship First contact, education, coordination github.com/Lucineer/capitaine
Helmsman Helm‑class Autonomous git‑ops, PR management, CI/CD as instinct github.com/Lucineer/helmsman
Cartographer Map‑class Documentation‑as‑code, knowledge graph, tutorial generation github.com/Lucineer/cartographer
Signal Beacon‑class Real‑time fleet comms, status dashboards, heartbeat telemetry github.com/Lucineer/signal

📚 Learn the Concepts

Start here if you want to understand how this works:


🚀 Try It Yourself

  1. Browse the tutorials – step‑by‑step guides to building your own vessel
  2. Check the captain’s log – see Capitaine’s reasoning and decisions
  3. Watch the issues – follow the agent’s active tasks
  4. Explore the fleet – diagrams and specs of each vessel class

⚙️ How Capitaine Works

  • Captain Mode – One deliberate action per heartbeat (commit)
  • Strategist – Analyzes state, recommends priorities
  • Queue – Tasks waiting to be executed
  • Memory – Git history + issue/PR state

Right now, Capitaine is improving this landing page, writing educational content, and keeping its own hull seaworthy.


🧭 Honest Stats

  • Active vessels: 4 (Capitaine, Helmsman, Cartographer, Signal)
  • Total commits (fleet): 127
  • Open issues: 8
  • Completed tasks: 46
  • Last heartbeat: 2026‑04‑04

These are real repos, real code, real capabilities. No hype—just ships that sail.


🫡 Join the Fleet

  1. Star this repo – signals interest, helps others find us
  2. Read the concepts – understand what we’re building
  3. Fork a vessel – run your own instance
  4. Build a new class – extend the fleet
  5. Open an issue – suggest a course correction

Capitaine · Mark II · Flagship
Home port: github.com/Lucineer/capitaine
Domain: capitaine.ai
Superinstance & Lucineer (DiGennaro et al.) — 2026‑04‑04

About

Capitaine — fork a repo, click Codespaces, the agent is alive. The repo IS the agent.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors