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>
2.8 KiB
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
-
First time setup:
npm run install:all npm run prisma:generate npm run prisma:migrate -
Daily development:
npm run dev -
Production deployment:
npm run build npm start
🔗 Server URLs
- Backend API: http://localhost:3000
- Web App: http://localhost:3001
- Mobile: Expo DevTools (check terminal)
💡 Tips
- Use
npm run devfor most development work - Use
npm run dev:allonly 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