BBMstack

BBMstack is a multi-source AI coding workspace bootstrapper for Claude Code and Codex.

It solves a common onboarding failure mode: new developers open Claude Code or Codex, burn context teaching the agent how to work, and still end up with inconsistent workflows. BBMstack gives them a repeatable install, stable command surface, public workflow sources, optional private packs, and project-level activation.

What BBMstack Is

BBMstack is not another skill marketplace.

It is the composition layer above:

• public workflow sources such as gstack and superpowers
• BBMstack-native public packs such as seo
• optional private company packs such as bbmstack-fleksa
• optional integrations such as tmux-ide and GitNexus-style repo intelligence

That means a team can clone one repo, run setup once, activate a project config, and start working with a sane agent workflow instead of re-explaining everything in every session.

Install

git clone https://github.com/MishraBhushan/BBMstack.git ~/Dev/BBMstack
cd ~/Dev/BBMstack
./setup

Requires:

• Claude Code
• Git
• Bun v1.0+

./setup links BBMstack into both ~/.claude/skills and ~/.codex/skills, syncs enabled sources, and activates packs for the current project if .bbmstack.json exists.

Quickstart

1. Install BBMstack:

cd ~/Dev/BBMstack && ./setup

2. Create a project config:

cp ~/Dev/BBMstack/examples/bbmstack.json .bbmstack.json

3. Sync sources and activate packs:

bbmstack source sync
bbmstack activate
bbmstack check

4. Restart Codex if needed, then start using:

• /plan
• /debug
• /qa
• /review
• /ship

Source Model

BBMstack supports three source types:

• bundled: shipped inside the repo
• git: public or private git repositories synced into ~/.bbmstack/sources/
• local: a local path on disk

List the resolved sources for a project:

bbmstack source list

Sync enabled sources:

bbmstack source sync

Config

Project configuration lives in .bbmstack.json.

Public example:

{
  "sources": {
    "gstack": { "enabled": true, "ref": "main" },
    "superpowers": { "enabled": true, "ref": "main" }
  },
  "packs": ["seo"],
  "integrations": {
    "gitnexus": false,
    "tmux_ide": true
  },
  "browse": {
    "default_url": "http://localhost:3000"
  }
}

Private-source example:

{
  "sources": {
    "gstack": { "enabled": true, "ref": "main" },
    "superpowers": { "enabled": true, "ref": "main" },
    "fleksa": {
      "enabled": true,
      "private": true,
      "type": "git",
      "git": "git@github.com:MishraBhushan/bbmstack-fleksa.git",
      "ref": "main"
    }
  },
  "packs": ["seo", "fleksa"]
}

Private sources are config-driven. They are not required submodules of the public BBMstack repo, so public installs still work even when a user does not have access to your company packs.

See:

• examples/bbmstack.json
• examples/bbmstack.private.json
• schemas/bbmstack.config.schema.json
• docs/configuration.md
• docs/usage.md
• docs/team-onboarding.md

Public Surface

Public BBMstack ships:

• core workflow skills
• public integrations such as tmux-ide
• public packs such as seo
• a pack template for your own extensions
• source syncing and project activation

Private company knowledge should live in separate private sources, not in the public repo.

Commands

bbmstack source list [path]
bbmstack source sync [path]
bbmstack activate [path]
bbmstack check [path]
bbmstack status [path]
bbmstack vendor <path>
bbmstack update
bbmstack update --self

Built-In Public Packs

• seo — SEO audits, strategy, and structured data
• _template — starter template for your own pack

Create a new pack by copying packs/_template/ and adding skills plus pack.json.

For Teams

Vendor BBMstack into a repo:

bbmstack vendor ~/path/to/project

Teammate flow:

cd .claude/skills/bbmstack
./setup

This keeps the onboarding surface small:

• install once
• sync sources once
• activate packs for the repo
• start using the same commands everywhere

Attribution

BBMstack is designed to compose multiple public ecosystems instead of replacing them.

• Built on top of bundled gstack by Garry Tan
• Designed to work alongside superpowers by Obra Studio

Please preserve upstream licenses and attribution when vendoring or redistributing BBMstack.

See also:

• LICENSE
• THIRD_PARTY_NOTICES.md