vxcloud/vxnode repository overview

vxcli salesshift leads search --seniority c_level --country AU --limit 25
vxcli salesshift leads quota
vxcli salesshift leads reveal <pool-id>
vxcli salesshift leads convert-from-pool <pool-id>… --lifecycle-stage lead
vxcli salesshift leads enrich acme.com

vxcli salesshift email send --to [email protected] --subject "…" --html "<p>…</p>"
vxcli salesshift campaigns report <campaign-id>
vxcli salesshift contacts list
vxcli salesshift workflows test-run <id>
vxcli salesshift sequences list

vxcli salesshift opportunities list --source hn --min-score 70
vxcli salesshift opportunities push-to-lead <id>
vxcli salesshift tasks add --title "Follow up" --goal "Book a call"
vxcli salesshift social post --content "…" && vxcli salesshift social send <post-id>
vxcli salesshift webmaster inspect https://example.com
vxcli salesshift billing plans

# Python
import vxsdk
ss = vxsdk.Client.load_from_vxcli().salesshift

page = ss.search_leads(filters={"seniority": ["c_level"], "country": ["AU"]}, limit=50)
ids  = [p["pool_person_id"] for p in page["results"][:10]]

print(ss.reveal_quota())              # allowance / remaining / unlimited
print(ss.preview_reveal_cost(ids))    # what this batch WOULD cost, before spending
ss.save_leads(ids)
print(vxsdk.describe_convert(ss.convert_from_pool(ids, lifecycle_stage="lead")))

// TypeScript
import { VxCloud } from '@vxcloud/sdk';
const c = new VxCloud({ apiKey: process.env.VX_API_KEY! });

const page = await c.leads.searchLeads({ filters: { country: ['AU'] }, limit: 50 });
const { job } = await c.social.distribute(postId);
console.log(`${job.speedup}x vs sequential`);

// Every delivery carries `simulated` — a deployment holding no social API
// credentials still returns delivery records. Surface it; never report a
// simulated post as published.
for (const d of job.deliveries) console.log(d.channel, d.simulated ? 'SIMULATED' : 'published');

# .env
VAULT_ADDR=https://vault.vxcloud.io
VAULT_ROLE_ID=<your-approle-role-id>
VAULT_SECRET_ID=<your-approle-secret-id>
TENANT_ORGANIZATION=<your-org>
TENANT_WORKSPACE=<your-workspace>
GIN_MODE=release
PORT=8744

docker run -d --name vxcloud-vxnode \
  --env-file .env \
  -p 8744:8744 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart unless-stopped \
  vxcloud/vxnode:latest

curl http://localhost:8744/api/v2/health      # -> {"status":"ok", ...}

services:
  vxnode:
    image: vxcloud/vxnode:latest
    container_name: vxcloud-vxnode
    restart: unless-stopped
    env_file: .env
    environment:
      - GIN_MODE=release
      - PORT=8744
    ports:
      - "8744:8744"            # use "127.0.0.1:8744:8744" if fronting with Nginx/TLS
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./generated:/app/generated
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8744/api/v2/health"]
      interval: 15s
      timeout: 5s
      retries: 3
    security_opt:
      - no-new-privileges:true
    cap_drop: [ALL]
    cap_add:  [NET_BIND_SERVICE]

docker compose up -d

curl -fsSL https://vxcloud.io/download/cli/install.sh | sh   # macOS / Linux
irm https://vxcloud.io/download/cli/install.ps1 | iex         # Windows
vxcli version                                                 # -> 2026.8.28

docker pull vxcloud/vxnode@sha256:<digest>     # from `docker buildx imagetools inspect vxcloud/vxnode:latest`