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.
gitgram-ai/gitgram/COMMANDS.md
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

2.8 KiB

Gitgram Commands Reference

Quick reference for all available commands in the Gitgram monorepo.

🚀 Development

Main Commands

npm run dev          # Start backend + web (recommended)
npm run dev:all      # Start backend + web + mobile
npm start            # Start production servers

Individual Projects

npm run dev:backend  # Backend only (port 3000)
npm run dev:web      # Web only (port 3001)
npm run dev:mobile   # Mobile (Expo)

Using Scripts

./scripts/dev.sh     # Backend + Web
./scripts/dev-all.sh # All projects
./scripts/start.sh   # Production (auto-builds)

📦 Installation

npm run install:all      # Install all projects
npm run install:backend  # Backend only
npm run install:mobile  # Mobile only
npm run install:web     # Web only

Or use script:

./scripts/install-all.sh

🏗️ Build

npm run build        # Build backend + web
npm run build:all    # Build all projects
npm run build:backend
npm run build:web
npm run build:mobile

🧪 Testing

npm test            # Run all tests
npm run test:backend
npm run test:mobile
npm run test:watch  # Watch mode

🔍 Linting

npm run lint        # Check all
npm run lint:fix    # Fix all
npm run lint:backend
npm run lint:mobile
npm run lint:web

🗄️ Database

npm run prisma:generate  # Generate Prisma client
npm run prisma:migrate   # Run migrations
npm run prisma:studio    # Open Prisma Studio

📦 Package Management

Add Package

npm run add:backend <package>
npm run add:mobile <package>
npm run add:web <package>

Or use script:

./scripts/add-package.sh backend express
./scripts/add-package.sh mobile react-native-vector-icons
./scripts/add-package.sh web next-auth

Remove Package

npm run remove:backend <package>
npm run remove:mobile <package>
npm run remove:web <package>

Or use script:

./scripts/remove-package.sh backend express

🧹 Cleanup

npm run clean       # Clean build artifacts
npm run clean:all   # Clean everything

Or use script:

./scripts/clean-all.sh

📝 Quick Workflow

  1. First time setup:

    npm run install:all
    npm run prisma:generate
    npm run prisma:migrate
    
  2. Daily development:

    npm run dev
    
  3. Production deployment:

    npm run build
    npm start
    

🔗 Server URLs

💡 Tips

  • Use npm run dev for most development work
  • Use npm run dev:all only when you need mobile too
  • Production servers require builds first (npm run build)
  • All scripts support Ctrl+C to stop servers
  • Check individual project READMEs for project-specific commands