⚡ VectorForce Docs PROD

VectorForce Cloud Documentation

Zero-dependency engineering memory & multi-machine encrypted context sync across Google Antigravity, Meta Muse, Claude Code, Codex, Cursor, Windsurf, Copilot, and Kiro. Docs URL: https://docs.vectorforce.in

1. Quickstart & CLI Workflow

Authenticate your terminal against VectorForce Cloud and sync local SQLite checkpoints with end-to-end encryption:

# 1. Initialize VectorForce in your repository
vf init "My-Project"

# 2. Authenticate CLI with VectorForce Cloud (https://cloud.vectorforce.in)
vf login

# 3. Verify active session & endpoint
vf whoami

# 4. Push local encrypted checkpoints to VectorForce Cloud
vf push

# 5. Pull & decrypt context on a second machine
vf pull
Existing workspace still pointing to old URL? Run vf login --url https://cloud.vectorforce.in or update remoteUrl in ~/.vectorforce/config.json and .vectorforce/config.json to https://cloud.vectorforce.in.

2. Cloud Environments & Domains

VectorForce Cloud runs globally on Cloudflare Workers, Durable Objects SQLite, D1 replication, and Supabase Auth across three isolated environments:

EnvironmentWeb PortalHeadless API / MCPDev Quick-Login
Prod (Live)https://cloud.vectorforce.inhttps://api.vectorforce.inDisabled
Preprod (Staging)https://preprod.vectorforce.inhttps://preprod.vectorforce.in/api/*Disabled
Dev (Sandbox)https://dev.vectorforce.inhttps://dev.vectorforce.in/api/*Enabled (Testing)
Docs Portalhttps://docs.vectorforce.in/docs on Cloud PortalPublic

3. Authentication & Google / GitHub OAuth

VectorForce Cloud supports three authentication paths:

  • Email + Password on https://cloud.vectorforce.in/login (backed by Supabase Auth + zero-dependency scrypt verification for immediate sign-in & CLI tokens).
  • Google & GitHub OAuth via Supabase Auth PKCE/redirect flow.
  • Scoped CLI / CI Tokens (vf_token_... and vf_temp_ci_...) for automated pipelines.

Enabling Google & GitHub OAuth in Supabase

Social login buttons require enabling Google and/or GitHub inside your Supabase project (Authentication → Sign In / Providers) with Client ID & Client Secret.
  1. Open your Supabase Dashboard → Authentication → Providers.
  2. Enable Google and/or GitHub and paste your OAuth App Client ID & Client Secret.
  3. Register this exact redirect/callback URI in Google Cloud Console & GitHub OAuth App settings:
    https://ycwdphwponegnfwzpkmt.supabase.co/auth/v1/callback
  4. In Supabase Authentication → URL Configuration, add allowed Redirect URLs:
    https://cloud.vectorforce.in/login and https://preprod.vectorforce.in/login

4. Zero-Knowledge E2EE Sync

Checkpoints pushed from your workstation are encrypted client-side before touching cloud storage:

  • In-Transit Envelope: Ephemeral X25519 ECDH key exchange + HKDF-SHA256 session key derivation + AES-256-GCM authenticated encryption.
  • Integrity & Authorship: Every packet is signed with Ed25519 and verified on pull before decryption.
  • At-Rest Wrapping: Cloud-stored ciphertext DEKs are wrapped with environment-isolated KEKs bound via AAD (org:project:task:checkpoint).

5. MCP Harness Configurations

Connect your IDE or coding agent directly to VectorForce Cloud MCP via vf-cloud or HTTP MCP:

{
  "mcpServers": {
    "vectorforce-cloud": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/VectorForceCloud/bin/vf-cloud.js",
        "mcp",
        "--url",
        "https://api.vectorforce.in"
      ],
      "env": {
        "VF_CLOUD_URL": "https://api.vectorforce.in",
        "VF_SUBSCRIPTION_KEY": "<your-vf-token-or-key>"
      }
    }
  }
}

6. REST & MCP API Reference

All API calls target https://api.vectorforce.in (or same-origin https://cloud.vectorforce.in/api/* from the Web UI):

Method & PathPurpose
GET /api/healthWorker environment, auth mode, URLs & encryption status
GET /api/auth/providersOAuth availability, Supabase client config & plans
POST /api/auth/signupRegister account via Supabase + scrypt & issue session cookie
POST /api/auth/loginAuthenticate credentials & optionally mint cli_token
GET /api/cloud/overviewFetch orgs, projects, tasks, checkpoints & governance status
POST /api/cloud/sync/pushStore X25519/AES-256-GCM/Ed25519 encrypted checkpoint
POST /api/cloud/sync/pullVerify Ed25519 signature, unwrap ciphertext & return briefing
POST /v1/mcpJSON-RPC Model Context Protocol endpoint for cloud tools