Production-ready NoSQL database that stores data in Git repositories with advanced features like GraphQL, AI-powered queries, version control, and performance optimizations.

1. Create a GitHub repo for your data.
2. Generate a GitHub token with repo permissions.
3. Install the CLI:

npm install -g gitdb-database

4. Connect:

   gitdb connect -t <token> -o <owner> -r <repo>

• gitdb connect -t <token> -o <owner> -r <repo>
  • Connects your CLI to a GitHub repository as your database.
  • Example:
    gitdb connect -t ghp_abc123 -o myuser -r mydb-repo

• gitdb collections — List all collections
• gitdb create-collection <name> — Create a new collection
• gitdb delete-collection <name> — Delete a collection

• gitdb documents <collection> — List all documents in a collection
• gitdb create-doc <collection> <json-data> — Add a new document
• gitdb read-doc <collection> <id> — Read a document by ID
• gitdb update-doc <collection> <id> <json-data> — Update a document
• gitdb delete-doc <collection> <id> — Delete a document by ID

• gitdb find <collection> <query> — Find documents matching a MongoDB-style query
• gitdb findone <collection> <query> — Find a single document matching the query

• gitdb version history <collection> — Show Git commit history for a collection
• gitdb version rollback <collection> --commit <hash> — Roll back a collection to a previous commit

• gitdb server — Start the GitDB server (REST/GraphQL API)
• gitdb server-start / gitdb server-stop / gitdb server-status — Manage the server process

• gitdb supermode enable --cache-size <n> — Enable performance optimizations
• gitdb graphql schema — Show the current GraphQL schema
• gitdb shell — Start an interactive shell for running commands

1. Create a GitHub repo for your data.
2. Generate a GitHub token with repo permissions.
3. Connect using the CLI:

gitdb connect -t <token> -o <owner> -r <repo>

1. Create collections for your data types:

   gitdb create-collection users
   gitdb create-collection products

2. Insert documents:

   gitdb create-doc users '{"name":"Alice","email":"alice@example.com"}'
   gitdb create-doc products '{"name":"Laptop","price":999.99}'

• Find users over 25:

  gitdb find users '{"age":{"$gt":25}}'

• Update a user:

  gitdb update-doc users <id> '{"email":"new@email.com"}'

• Delete a product:

  gitdb delete-doc products <id>

• View history:

  gitdb version history users

• Rollback:

  gitdb version rollback users --commit <hash>

• Start the server:

gitdb server

• Access REST API:
  http://localhost:7896/api/v1/collections/users
• Access GraphQL API:
  http://localhost:7896/graphql

Inside gitdb shell, you can use:

• set token <token>
• set owner <owner>
• set repo <repo>
• use <collection>
• create-collection <name>
• show collections
• show docs
• insert <JSON>
• find <id>
• findone <json-query>
• count [json-query]
• update <id> <JSON>
• delete <id>
• help
• exit

import { GitDBClient } from 'gitdb-client';

const client = new GitDBClient({
  owner: 'your-github-username',
  repo: 'your-repo',
  token: 'your-github-token',
});

// Insert a document
await client.insert('users', { name: 'Alice', email: 'alice@example.com' });

// Query documents
const users = await client.findOne('users', { name: 'Alice' });

// Update a document
await client.update('users', users[0].id, { age: 31 });

// Delete a document
await client.delete('users', users[0].id);

• Full Book & Advanced Docs: GITDB-Guide.md (Full Book)
• SDK Docs: See links in the table above for each language
• API Reference: GITDB-COMPLETE-BOOK.md and server endpoints

If you want a deep-dive into any specific command, workflow, or integration, just ask!