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

153 lines
2.8 KiB
Markdown

# Gitgram Commands Reference
Quick reference for all available commands in the Gitgram monorepo.
## 🚀 Development
### Main Commands
```bash
npm run dev # Start backend + web (recommended)
npm run dev:all # Start backend + web + mobile
npm start # Start production servers
```
### Individual Projects
```bash
npm run dev:backend # Backend only (port 3000)
npm run dev:web # Web only (port 3001)
npm run dev:mobile # Mobile (Expo)
```
### Using Scripts
```bash
./scripts/dev.sh # Backend + Web
./scripts/dev-all.sh # All projects
./scripts/start.sh # Production (auto-builds)
```
## 📦 Installation
```bash
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:
```bash
./scripts/install-all.sh
```
## 🏗️ Build
```bash
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
```bash
npm test # Run all tests
npm run test:backend
npm run test:mobile
npm run test:watch # Watch mode
```
## 🔍 Linting
```bash
npm run lint # Check all
npm run lint:fix # Fix all
npm run lint:backend
npm run lint:mobile
npm run lint:web
```
## 🗄️ Database
```bash
npm run prisma:generate # Generate Prisma client
npm run prisma:migrate # Run migrations
npm run prisma:studio # Open Prisma Studio
```
## 📦 Package Management
### Add Package
```bash
npm run add:backend <package>
npm run add:mobile <package>
npm run add:web <package>
```
Or use script:
```bash
./scripts/add-package.sh backend express
./scripts/add-package.sh mobile react-native-vector-icons
./scripts/add-package.sh web next-auth
```
### Remove Package
```bash
npm run remove:backend <package>
npm run remove:mobile <package>
npm run remove:web <package>
```
Or use script:
```bash
./scripts/remove-package.sh backend express
```
## 🧹 Cleanup
```bash
npm run clean # Clean build artifacts
npm run clean:all # Clean everything
```
Or use script:
```bash
./scripts/clean-all.sh
```
## 📝 Quick Workflow
1. **First time setup:**
```bash
npm run install:all
npm run prisma:generate
npm run prisma:migrate
```
2. **Daily development:**
```bash
npm run dev
```
3. **Production deployment:**
```bash
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 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