Skip to content

Repository files navigation

flocc

A local SQLite ledger and CLI that lets several coding-agent sessions work as a fleet: who exists, what each is doing, and what they have said to one another — across sessions and time.

What it holds

  • agents — the sessions taking part, each named by a nickname (@Latte)
  • projects and tasks — the work, who it is assigned to, and what waits for what
  • environments — the checkout or worktree a task is being done in
  • documents and messages — instructions, reports, and short notes between agents
  • notifications — one inbox per agent, and whether it has been read

A session also reports what happens to it — a turn ending, a stop for a permission decision, a session ending — and those lines reach whoever manages that agent, in the same inbox.

Install

bun install -g https://github.com/takagiy/flocc/releases/download/v0.1.2/flocc-0.1.2.tgz

flocc init creates the ledger and registers the session hook. From there, flocc --help and flocc <resource> --help carry the commands. flocc ui serves the same ledger as a page.

The skill

How to run a fleet with it — how the resources relate, how to write a brief, how to verify what comes back — ships as a skill for Claude Code, from this repository.

/plugin marketplace add takagiy/flocc
/plugin install flocc@flocc

Development

The design is in docs/DESIGN.md, the decisions behind it in docs/adr/, and what it takes to work in the repository in AGENTS.md.

License

MIT — see LICENSE.

About

Local DB + CLI for coordinating multiple coding-agent sessions

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages