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
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:
| Environment | Web Portal | Headless API / MCP | Dev Quick-Login |
|---|---|---|---|
| Prod (Live) | https://cloud.vectorforce.in | https://api.vectorforce.in | Disabled |
| Preprod (Staging) | https://preprod.vectorforce.in | https://preprod.vectorforce.in/api/* | Disabled |
| Dev (Sandbox) | https://dev.vectorforce.in | https://dev.vectorforce.in/api/* | Enabled (Testing) |
| Docs Portal | https://docs.vectorforce.in | /docs on Cloud Portal | Public |
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
scryptverification for immediate sign-in & CLI tokens). - Google & GitHub OAuth via Supabase Auth PKCE/redirect flow.
- Scoped CLI / CI Tokens (
vf_token_...andvf_temp_ci_...) for automated pipelines.
Enabling Google & GitHub OAuth in Supabase
- Open your Supabase Dashboard → Authentication → Providers.
- Enable Google and/or GitHub and paste your OAuth App Client ID & Client Secret.
- Register this exact redirect/callback URI in Google Cloud Console & GitHub OAuth App settings:
https://ycwdphwponegnfwzpkmt.supabase.co/auth/v1/callback - In Supabase Authentication → URL Configuration, add allowed Redirect URLs:
https://cloud.vectorforce.in/loginandhttps://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
X25519ECDH key exchange +HKDF-SHA256session key derivation +AES-256-GCMauthenticated encryption. - Integrity & Authorship: Every packet is signed with
Ed25519and 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 & Path | Purpose |
|---|---|
GET /api/health | Worker environment, auth mode, URLs & encryption status |
GET /api/auth/providers | OAuth availability, Supabase client config & plans |
POST /api/auth/signup | Register account via Supabase + scrypt & issue session cookie |
POST /api/auth/login | Authenticate credentials & optionally mint cli_token |
GET /api/cloud/overview | Fetch orgs, projects, tasks, checkpoints & governance status |
POST /api/cloud/sync/push | Store X25519/AES-256-GCM/Ed25519 encrypted checkpoint |
POST /api/cloud/sync/pull | Verify Ed25519 signature, unwrap ciphertext & return briefing |
POST /v1/mcp | JSON-RPC Model Context Protocol endpoint for cloud tools |