This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as
opaque submodule gitlinks on GitHub) into fully-tracked first-party content.

AITM now merges its 7 vendored repos as first-party engines:
- memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts
- git: vendored C git (bundled binary) + gitnexus (in-process code intelligence)
- agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess)

Includes the full session's product build: Gitgram web/mobile/backend features,
AITM website/CLI/MCP, the unified memory layer, engine build tooling
(scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md),
and extensive test suites.

Build artifacts, node_modules, external/, and gemini-cli are gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 14:14:09 +03:00
..

beads Development Container

This devcontainer configuration provides a fully-configured development environment for beads with:

  • Go 1.23 development environment
  • bd CLI built and installed from source
  • Git hooks automatically installed
  • All dependencies pre-installed

Quick Start

GitHub Codespaces

  1. Click the "Code" button on GitHub
  2. Select "Create codespace on main"
  3. Wait for the container to build (~2-3 minutes)
  4. The environment will be ready with bd installed and configured

VS Code Remote Containers

  1. Install the Remote - Containers extension
  2. Open the beads repository in VS Code
  3. Click "Reopen in Container" when prompted (or use Command Palette: "Remote-Containers: Reopen in Container")
  4. Wait for the container to build

What Gets Installed

The setup.sh script automatically:

  1. Builds bd from source (go build ./cmd/bd)
  2. Installs bd to /usr/local/bin/bd
  3. Runs bd init --quiet (non-interactive initialization)
  4. Installs git hooks from examples/git-hooks/
  5. Downloads Go module dependencies

Verification

After the container starts, verify everything works:

# Check bd is installed
bd --version

# Check for ready tasks
bd ready

# View project stats
bd stats

Git Configuration

Your local .gitconfig is mounted into the container so your git identity is preserved. If you need to configure git:

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

Troubleshooting

bd command not found:

  • The setup script should install bd automatically
  • Manually run: bash .devcontainer/setup.sh

Git hooks not working:

  • Check if hooks are installed: ls -la .git/hooks/
  • Manually install: bash examples/git-hooks/install.sh

Container fails to build:

  • Check the container logs for specific errors
  • Ensure Docker/Podman is running and has sufficient resources
  • Try rebuilding: Command Palette → "Remote-Containers: Rebuild Container"
  • GitHub Issue #229: Git hooks not available in devcontainers
  • bd-ry1u: Publish official devcontainer configuration