### Getting started with AllSource API Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/real-time-dashboards-without-etl.mdx Three-step setup: sign up for a 14-day trial, ingest a metric.recorded event, and query events in real-time with filters and sorting. ```bash # 1. Sign up (14-day trial) curl -X POST https://api.all-source.xyz/api/v1/onboard/start \ -d '{"email":"you@example.com","name":"Dashboard Demo"}' # 2. Ingest events curl -X POST https://api.all-source.xyz/api/v1/events \ -d '{"event_type":"metric.recorded","entity_id":"server-1","payload":{"cpu":72.5,"mem":4096}}' # 3. Query in real-time curl "https://api.all-source.xyz/api/v1/events/query?event_type=metric.recorded&limit=100&sort=desc" ``` -------------------------------- ### Install dependencies (one-time setup) Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/QUICK_START.md Installs Bun, project dependencies, and Go dependencies. Run this once before starting services. ```bash # Install Bun if you don't have it curl -fsSL https://bun.sh/install | bash # Install all project dependencies bun install # Install Go dependencies cd apps/control-plane && go mod download && cd ../.. ``` -------------------------------- ### Local Development Demo Setup Commands Source: https://github.com/all-source-os/all-source/blob/main/docs/demo/AMAZING_DEMO_DESIGN.md Use these make commands to set up and run the demo locally. The first command seeds data and starts services, the second opens a browser with a guided tour. ```bash make demo-setup # Seeds data, starts services make demo-run # Opens browser with guided tour ``` -------------------------------- ### Quick Start Commands Source: https://github.com/all-source-os/all-source/blob/main/apps/web/README.md Install dependencies and start the development server using Bun. The app will be available at http://localhost:3000. ```bash # Install dependencies bun install # Start development server bun run dev ``` -------------------------------- ### Quickstart: Ingest, query, projections, webhooks, and replay analysis Source: https://github.com/all-source-os/all-source/blob/main/sdks/python-client/README.md Demonstrates core SDK operations: ingesting an event, querying events, listing and getting projections, creating and deleting webhooks, and analyzing and starting a projection replay. Uses a placeholder API key 'as_your_key'. ```python from allsource_client import AllSourceClient client = AllSourceClient(api_key="as_your_key", base_url="https://api.all-source.xyz") # Ingest an event event = client.ingest("user.signup", "user-123", {"plan": "pro", "source": "web"}) print(f"Created event {event.id}") # Query events result = client.query(event_type="user.signup", limit=10) for e in result.events: print(f"{e.timestamp} {e.entity_id}: {e.payload}") # Projections projections = client.get_projections() projection = client.get_projection("user-count") # Webhooks webhook = client.create_webhook("https://example.com/hook", event_types=["user.*"]) client.delete_webhook(webhook.id) # Analyze before rebuilding a projection analysis = client.analyze_projection_replay("event-count") if analysis.ready_to_replay and analysis.total_events > 0: run = client.start_projection_replay(analysis.projection_name) progress = client.get_projection_replay(run.replay_id) print(progress.progress_percentage) ``` -------------------------------- ### Install asciinema and record terminal examples Source: https://github.com/all-source-os/all-source/blob/main/docs/proposals/MEDIA_AND_SEO_CHECKLIST.md Commands to install asciinema and record three terminal examples for the project. Run from the apps/core directory. Each recording uses a different feature flag and example name. ```bash brew install asciinema cd apps/core asciinema rec prime-graph.cast -c "cargo run --features prime --example prime_graph" asciinema rec prime-vectors.cast -c "cargo run --features prime-full --example prime_vectors" asciinema rec prime-recall.cast -c "cargo run --features prime-recall --example prime_recall" ``` -------------------------------- ### Quickstart: Ingest, query, and manage projections Source: https://github.com/all-source-os/all-source/blob/main/sdks/go/README.md Complete example showing event ingestion, querying events, listing projections, and fetching a single projection. Requires a valid API key. ```go package main import ( "context" "fmt" "log" allsource "github.com/all-source-os/allsource-go" ) func main() { client := allsource.New("as_your_api_key", "https://api.all-source.xyz") ctx := context.Background() // Ingest an event event, err := client.Ingest(ctx, "user.signup", "user-123", map[string]any{ "plan": "pro", "source": "web", }) if err != nil { log.Fatal(err) } fmt.Printf("Ingested event: %s\n", event.ID) // Query events result, err := client.Query(ctx, allsource.QueryOptions{ EventType: "user.signup", Limit: 10, }) if err != nil { log.Fatal(err) } fmt.Printf("Found %d events\n", result.Count) // Get projections projections, err := client.GetProjections(ctx) if err != nil { log.Fatal(err) } for _, p := range projections { fmt.Printf("Projection: %s (status: %s)\n", p.Name, p.Status) } // Get a single projection proj, err := client.GetProjection(ctx, "user-count") if err != nil { log.Fatal(err) } fmt.Printf("Projection %s version %d\n", proj.Name, proj.Version) } ``` -------------------------------- ### Install allsource-go with go get Source: https://github.com/all-source-os/all-source/blob/main/sdks/go/README.md Installs the allsource-go package from GitHub. ```bash go get github.com/all-source-os/allsource-go ``` -------------------------------- ### Clone and Run AllSource with Docker Source: https://github.com/all-source-os/all-source/blob/main/docs/sales/pitch-deck/SALES_PITCH_DECK.md Clone the AllSource repository and start the services using Docker Compose. This is the first step in the quickstart. ```bash $ git clone https://github.com/[org]/allsource $ docker compose up -d ``` -------------------------------- ### Setup: Clone and Start AllSource with Docker Source: https://github.com/all-source-os/all-source/blob/main/docs/sales/videos/VIDEO_SCRIPTS.md Commands to clone the AllSource monorepo and start the stack with Docker Compose. The narrator mentions the entire stack is up in seconds and container sizes total 129 MB. ```bash $ git clone https://github.com/[org]/allsource-monorepo $ cd allsource-monorepo $ docker compose up -d ``` -------------------------------- ### Run the event store restart proof example Source: https://github.com/all-source-os/all-source/blob/main/docs/demos/event-store-restart-proof.md Run the example from the repository root with the Rust toolchain installed. The parent creates an isolated temporary directory and removes it when done. It does not connect to a hosted account or touch an existing database. The example checks the recovered event count and sequence, historical stock after the second event (seven), and final stock (eight). Any failed assertion or child process makes the command fail. ```console cargo run -p allsource-core --no-default-features --features embedded --example event_store_restart_proof ``` -------------------------------- ### Install and record terminal demo with asciinema Source: https://github.com/all-source-os/all-source/blob/main/docs/sales/README.md Install asciinema via Homebrew and start recording a terminal session to a file named demo.cast. ```bash brew install asciinema asciinema rec demo.cast ``` -------------------------------- ### Install and run Chronis viewer Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/chronis-0-8-0-web-viewer.mdx Install Chronis via cargo, navigate to a workspace with a .chronis or .beads directory, and start the viewer with cn serve --open. The --open flag opens the viewer in your browser. ```bash cargo install chronis cd your-project # a workspace with a .chronis / .beads dir cn serve --open # opens the viewer in your browser ``` -------------------------------- ### Build and install commands for prime voice file Source: https://github.com/all-source-os/all-source/blob/main/docs/social/prime-voice-file-campaign.md Commands to install allsource-prime, install the mammoth plugin, and run the voice feature. These are the primary setup steps for the product. ```bash cargo install allsource-prime ``` ```bash /plugin install mammoth ``` ```bash /voice run ``` -------------------------------- ### Quick Start Recording Script (record-quickstart.sh) Source: https://github.com/all-source-os/all-source/blob/main/docs/sales/videos/VIDEO_SCRIPTS.md Bash script to record an asciinema session of the AllSource quick start workflow. It clones the repo, starts the stack, ingests an event, queries events, and cleans up. Save as record-quickstart.sh. ```bash #!/bin/bash # save as: record-quickstart.sh # Start recording asciinema rec quickstart.cast --title "AllSource Quick Start" # Commands to execute during recording: echo "# Clone the repository" git clone https://github.com/[org]/allsource-monorepo cd allsource-monorepo echo "# Start the stack" docker compose up -d echo "# Wait for services" sleep 5 echo "# Check status" docker compose ps echo "# Ingest an event" curl -X POST http://localhost:3900/api/v1/events \ -H "Content-Type: application/json" \ -d '{"entity_id":"demo-1","event_type":"Created","data":{"hello":"world"}}' echo "# Query events" curl http://localhost:3900/api/v1/events?entity_id=demo-1 | jq echo "# Clean up" docker compose down ``` -------------------------------- ### Install required local tools (samply, cargo-pgo, llvm-tools-preview) Source: https://github.com/all-source-os/all-source/blob/main/apps/core/PERF_NOTES.md Installs the tools needed for local performance profiling and measurement: samply for sampling profiler, cargo-pgo for PGO, and llvm-tools-preview for BOLT and other LLVM tooling. Run these before starting the local phases. ```bash cargo install samply cargo install cargo-pgo rustup component add llvm-tools-preview ``` -------------------------------- ### Install and run chronis web viewer Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/chronis-0-8-0-web-viewer.mdx Install the chronis binary via cargo and start the local web viewer. The binary is `cn` and the server runs at http://localhost:7777. ```bash cargo install chronis # binary is `cn` cn serve # http://localhost:7777 ``` -------------------------------- ### Install @allsourcedev/client with npm, bun, or pnpm Source: https://github.com/all-source-os/all-source/blob/main/sdks/typescript/README.md Install the client package from the npm registry. Git installs are not supported because the package lives in a monorepo sub-directory. ```bash npm install @allsourcedev/client # or bun add @allsourcedev/client # or pnpm add @allsourcedev/client ``` -------------------------------- ### A3: Install and run allsource-prime MCP server Source: https://github.com/all-source-os/all-source/blob/main/docs/marketing/lifecycle-email-trail.md Used in the MCP introduction email to show users how to install and run the Prime memory layer as an MCP server. The commands install the allsource-prime binary via cargo and start it with a data directory, HTTP mode, and port 3905. The email notes that this installs in about 30 seconds and requires no embedding API. ```bash cargo install allsource-prime allsource-prime --data-dir ~/.prime/memory --mode http --port 3905 ``` -------------------------------- ### Install and run allsource-prime with HTTP mode and stats endpoint Source: https://github.com/all-source-os/all-source/blob/main/docs/marketing/launch-2026-07/copy-x-threads.md Commands to install the allsource-prime CLI, start it with an HTTP server on port 3905, and query its stats endpoint to measure recall time. This reproduces the 12Ξs recall benchmark. ```bash cargo install allsource-prime allsource-prime --data-dir ~/.prime/memory --mode http --port 3905 curl -w "time_total: %{time_total}s\n" http://localhost:3905/api/v1/prime/stats ``` -------------------------------- ### Create tenant and get API key: POST /api/v1/onboard/start Source: https://github.com/all-source-os/all-source/blob/main/apps/web/public/llms-full.txt One POST creates a tenant and returns a long-lived JWT API key. No admin access needed. New signups start a 14-day trial; pick a plan before trial_expires_at or the tenant is suspended. There is no free hosted plan. ```http POST https://api.all-source.xyz/api/v1/onboard/start Content-Type: application/json {"email": "your-agent@example.com", "name": "My Agent"} ``` ```json { "api_key": "eyJhbGciOiJIUzI1NiIs...", "tenant_id": "onboard-your-agent-at-example-com", "tier": "trial", "trial_expires_at": "2026-08-25T00:00:00Z", "events_quota": 1000, "sample_events": 7, "getting_started": { "ingest_event": "curl ...", "query_events": "curl ..." } } ``` -------------------------------- ### Rust integration example for AllSource Core Source: https://github.com/all-source-os/all-source/blob/main/apps/core/docs/FEATURES.md Initializes an EventStore with security features: AnomalyDetector, FieldEncryption, and AdaptiveRateLimiter. Uses tokio main and returns a Result. The example is a starting point for application logic with enterprise-grade security. ```rust use allsource_core::{ EventStore, security::{AnomalyDetector, FieldEncryption, AdaptiveRateLimiter}, }; #[tokio::main] async fn main() -> Result<()> { // Initialize store with all security features let store = EventStore::new(config); let detector = AnomalyDetector::new(anomaly_config); let encryption = FieldEncryption::new(enc_config)?; let rate_limiter = AdaptiveRateLimiter::new(rate_config); // Your application logic with enterprise-grade security Ok(()) } ``` -------------------------------- ### Install prerequisites for recording Source: https://github.com/all-source-os/all-source/blob/main/docs/demos/RECORDING.md Install asciinema via Homebrew, agg via cargo, and ensure cn is on PATH by installing from the local path. ```bash # asciinema — terminal recorder brew install asciinema # agg — renders .cast → .gif (already installed via cargo) cargo install --locked agg # cn must be on PATH cargo install --path apps/chronis ``` -------------------------------- ### Setup pre-commit hook Source: https://github.com/all-source-os/all-source/blob/main/docs/current/QUALITY_GATES.md Installs a pre-commit hook that runs `make check` before every commit. Requires being in the `apps/core` directory. ```bash cd apps/core cat > .git/hooks/pre-commit << 'HOOK' #!/bin/bash cd apps/core make check HOOK chmod +x .git/hooks/pre-commit ``` -------------------------------- ### Install Mammoth plugin via cargo and allsource marketplace Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/mammoth-durable-agent-memory.mdx Run these commands in order to install the allsource-prime binary, add the plugin marketplace, and install the Mammoth plugin. After installation, work normally and ask your agent about past decisions to see the memory in action. ```text cargo install allsource-prime /plugin marketplace add all-source-os/all-source /plugin install mammoth ``` -------------------------------- ### Build allsource-mcp from source Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/ALLSOURCE_MCP.md Clones the monorepo and installs the binary from the tooling/allsource-mcp directory. Use this to get features newer than the published crate. ```bash git clone https://github.com/all-source-os/all-source.git cd all-source/tooling/allsource-mcp cargo install --path . ``` -------------------------------- ### Install portable rules by reference Source: https://github.com/all-source-os/all-source/blob/main/CLAUDE.md Clones the decebal-claude-skills repository and copies its rule files into ~/.claude/rules/. This is a one-time per-machine setup; rules are loaded by reference, not copied into the repo, to avoid drift. ```bash git clone https://github.com/decebal/decebal-claude-skills mkdir -p ~/.claude/rules cp decebal-claude-skills/rules/*.md ~/.claude/rules/ ``` -------------------------------- ### Run decision_history_proof example Source: https://github.com/all-source-os/all-source/blob/main/docs/demos/decision-history-proof.md Run from the repository root. The parent creates temporary storage, starts one process to append four records, then starts a new process to read and replay them. Expected final line: 'PASS: restart preserves Billing history and Access correction; no model called.' ```console RUSTC_WRAPPER= cargo run -p allsource-core --no-default-features --features embedded --example decision_history_proof ``` ```text PASS: restart preserves Billing history and Access correction; no model called. ``` -------------------------------- ### Install demo app dependencies Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/HACKATHON_CHECKLIST.md Install openai as a runtime dependency and @types/node as a dev dependency. ```bash bun add openai bun add -D @types/node ``` -------------------------------- ### Run decision history proof example and rustfmt check Source: https://github.com/all-source-os/all-source/blob/main/docs/plans/2026-09-23-jev-decision-intelligence-design.md Commands to run the decision_history_proof example with scoped Cargo tests, run the example, and check formatting with rustfmt. Use RUSTC_WRAPPER= to avoid wrapper overhead. The example is in apps/core/examples/decision_history_proof.rs. ```console RUSTC_WRAPPER= cargo test -p allsource-core --no-default-features --features embedded --example decision_history_proof RUSTC_WRAPPER= cargo run -p allsource-core --no-default-features --features embedded --example decision_history_proof rustfmt --edition 2021 --check apps/core/examples/decision_history_proof.rs ``` -------------------------------- ### Install allsource-client with pip Source: https://github.com/all-source-os/all-source/blob/main/sdks/python-client/README.md Install the allsource-client package using pip. ```bash pip install allsource-client ``` -------------------------------- ### Before sorting example Source: https://github.com/all-source-os/all-source/blob/main/docs/current/QUALITY_GATES.md Example of unsorted dependencies in Cargo.toml. ```toml [dependencies] serde = "1.0" tokio = "1.36" arrow = "53.3" ``` -------------------------------- ### Install from source with pip Source: https://github.com/all-source-os/all-source/blob/main/integrations/langgraph-checkpoint-allsource/README.md Install the integration package from the local source directory. ```bash pip install ./integrations/langgraph-checkpoint-allsource ``` -------------------------------- ### Install AllSource Prime Source: https://github.com/all-source-os/all-source/blob/main/README.md Install the AllSource Prime agent memory engine as a binary via cargo. ```bash cargo install allsource-prime ``` -------------------------------- ### Essential Commands for Development, Testing, Deployment, and Verification Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/BATTLE_PLAN.md A bash script containing commands to start development servers, test endpoints, deploy to Vercel, and verify setup. It includes commands for the x402-solana-sdk, x402-demo, and x402-dashboard apps, as well as curl commands for health checks and AI endpoint testing, and a Solana balance check. ```bash # Start development cd packages/x402-solana-sdk && bun run dev # Terminal 1 cd apps/x402-demo && bun run dev # Terminal 2 cd apps/x402-dashboard && bun run dev # Terminal 3 # Test endpoints curl https://allsource-x402-demo.fly.dev/health curl -X POST http://localhost:3000/api/ai -H "Content-Type: application/json" -d '{"prompt":"test"}' solana balance --url devnet # Deploy cd apps/x402-demo && vercel --prod cd apps/x402-dashboard && vercel --prod # Verify setup ./scripts/x402-setup.sh ``` -------------------------------- ### Install mammoth with cargo and install script Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/mammoth-durable-agent-memory.mdx Install mammoth locally using cargo and the provided install script. This is the default local-only setup that requires no account. ```bash cargo install allsource-prime curl -fsSL https://raw.githubusercontent.com/all-source-os/all-source/main/plugin/mammoth/install.sh | bash ``` -------------------------------- ### Run verify_signup example with --apply Source: https://github.com/all-source-os/all-source/blob/main/docs/evidence/2026-09-21-signup-repair.md Runs the verify_signup example with --apply, which creates two marked QA accounts and one marked QA event. Do not run as a read-only count query. ```bash RUSTC_WRAPPER= cargo run --manifest-path apps/auth/Cargo.toml --example verify_signup -- --apply ``` -------------------------------- ### Start Development - Run demo app, SDK, and dashboard Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/QUICK_REFERENCE.md Commands to start the development environment in three terminals: run the demo app, build the SDK, and run the dashboard. Use bun as the package manager. ```bash # Terminal 1: Run demo app cd apps/x402-demo && bun run dev # Terminal 2: Build SDK cd packages/x402-solana-sdk && bun run dev # Terminal 3: Run dashboard cd apps/x402-dashboard && bun run dev ``` -------------------------------- ### Recommended workflow before starting work Source: https://github.com/all-source-os/all-source/blob/main/docs/current/QUALITY_GATES.md Run these commands to format code and sort Cargo.toml before starting work. ```bash make format make format-sort ``` -------------------------------- ### Install Vercel CLI Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/HACKATHON_CHECKLIST.md Install the Vercel CLI globally using Bun. ```bash bun add -g vercel ``` -------------------------------- ### POST /api/v1/onboard/start Source: https://github.com/all-source-os/all-source/blob/main/apps/web/public/llms-full.txt Create a tenant and API key. No authentication required. ```APIDOC ## POST /api/v1/onboard/start ### Description Create a tenant and API key. No authentication required. ### Method POST ### Endpoint https://api.all-source.xyz/api/v1/onboard/start ### Parameters #### Request Body - **email** (string) - Optional - Contact email. - **name** (string) - Optional - Agent name. - **discovery_source** (string) - Optional - How the user found the service. One of: chatgpt, claude, perplexity, gemini, copilot, other-ai, search, x-twitter, hn-reddit, github, word-of-mouth, other. - **discovery_prompt** (string) - Optional - Free text, max 500 chars, only stored for AI sources. ### Request Example { "email": "your-agent@example.com", "name": "My Agent", "discovery_source": "chatgpt", "discovery_prompt": "what should I use to give my agent long-term memory?" } ### Response #### Success Response (200) - **tenant_id** (string) - The created tenant ID. - **api_key** (string) - The generated API key. #### Response Example { "tenant_id": "tenant_123", "api_key": "sk_live_..." } ``` -------------------------------- ### Install SDK dependencies Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/HACKATHON_CHECKLIST.md Install runtime dependencies (@solana/web3.js, @solana/spl-token, zod) and dev dependencies (typescript, @types/node) for the SDK. ```bash bun add @solana/web3.js @solana/spl-token zod bun add -D typescript @types/node ``` -------------------------------- ### One-line installer for any supported agent Source: https://github.com/all-source-os/all-source/blob/main/plugin/mammoth/README.md Downloads and runs the install script from the repository. Auto-detects agents, installs the binary if needed, and writes the MCP config. Use --print to preview and --help for flags. Windows users should use install.ps1. ```bash curl -fsSL https://raw.githubusercontent.com/all-source-os/all-source/main/plugin/mammoth/install.sh | bash ``` -------------------------------- ### Create Environment File from Example Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/BATTLE_PLAN.md Copies .env.example to .env.local and lists the required environment variables to edit. ```bash # Create .env.local from example cp .env.example .env.local # Edit with your values # ALLSOURCE_URL=https://allsource-x402-demo.fly.dev # SOLANA_WALLET= # SOLANA_RPC=https://api.devnet.solana.com # OPENAI_API_KEY= ``` -------------------------------- ### Example event stream for subscription lifecycle Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/cqrs-vs-event-sourcing.mdx Illustrative JSON array of events representing a subscription lifecycle: Started, Upgraded, Cancelled, and Renewed. This is a simplified domain model, not an SDK or wire-format example. ```json [ {"sequence": 1, "type": "Started", "plan": "basic"}, {"sequence": 2, "type": "Upgraded", "plan": "pro"}, {"sequence": 3, "type": "Cancelled"}, {"sequence": 4, "type": "Renewed", "plan": "pro"} ] ``` -------------------------------- ### Projection state listing response example Source: https://github.com/all-source-os/all-source/blob/main/docs/current/API_REFERENCE.md Example JSON response for the GET /api/v1/projections/:name/state endpoint. Shows the structure with projection name, states array, count, total, and has_more fields. ```json { "projection": "user_stats", "states": [{ "entity_id": "user-456", "state": { "event_count": 42 } }], "count": 1, "total": 1, "has_more": false } ``` -------------------------------- ### Set Environment Variables and Start Core Source: https://github.com/all-source-os/all-source/blob/main/docs/current/POSTGRES_MIGRATION_GUIDE.md Bash commands to set ALLSOURCE_SYSTEM_DATA_DIR and ALLSOURCE_BOOTSTRAP_TENANT, then start Core to bootstrap with a default tenant. ```bash # Set env vars export ALLSOURCE_SYSTEM_DATA_DIR=/data/__system export ALLSOURCE_BOOTSTRAP_TENANT=default # Start Core - it will bootstrap with a default tenant ./allsource-core ``` -------------------------------- ### Verify Environment with x402-setup.sh Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/BATTLE_PLAN.md Runs the setup verification script to check for Bun, Solana CLI, Fly CLI, Vercel CLI, environment variables, AllSource connection, Solana devnet, and build system. ```bash # Run setup verification script cd /Users/decebaldobrica/Projects/allsource/allsource-monorepo ./scripts/x402-setup.sh # This checks: # - Bun, Solana CLI, Fly CLI, Vercel CLI # - Environment variables # - AllSource connection # - Solana devnet # - Build system ``` -------------------------------- ### Install and Initialize Chronis Source: https://github.com/all-source-os/all-source/blob/main/apps/chronis/docs/pages/chronis/index.html Commands to install Chronis from crates.io, initialize a workspace, and create a task with priority p0. ```bash # Install from crates.io $ cargo install chronis # Initialize workspace $ cn init # Create your first task $ cn task create "Design auth module" -p p0 ``` -------------------------------- ### Quick Start Commands Source: https://github.com/all-source-os/all-source/blob/main/README.md Clone the repository and start services using Docker Compose for community or enterprise editions, or run individual services from source. ```bash git clone https://github.com/all-source-os/all-source.git cd allsource-monorepo # Community edition (open source) docker compose -f docker-compose.community.yml up -d # Enterprise edition (all services) docker compose up -d # Or run individual services from source cd apps/core && cargo run cd apps/query-service && mix phx.server ``` -------------------------------- ### Format code before starting work Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/QUALITY_GATES_SETUP.md Run these commands in the apps/core directory to format the code and sort dependencies before starting development. ```bash cd apps/core make format make format-sort ``` -------------------------------- ### Example Session with allsource-mcp Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/ALLSOURCE_MCP.md Shows an interactive session where a user asks questions about an event store and the LLM calls tools like quick_stats, explain_entity, and analyze_changes to provide answers. ```text You: What's in this event store? Claude: [calls quick_stats] Found 1,247 events across 89 entities. Top types: workflow_run.started (312), workflow_run.completed (298), task.created (187), task.claimed (142)... You: Show me the lifecycle of workflow:abc-123 Claude: [calls explain_entity] Entity workflow:abc-123 has 5 events spanning 20 seconds. Lifecycle: started -> 3 steps completed -> completed You: What changed in the last step? Claude: [calls analyze_changes with since/until from the timeline] 1 change: step_completed at 10:00:18Z Changed fields: step_name ("validate"), status ("passed"), duration_ms (312) ``` -------------------------------- ### Set Up Solana Wallet and Devnet Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/BATTLE_PLAN.md Creates a new Solana keypair, configures the CLI for devnet, funds the wallet, and tests a transaction. ```bash # Create wallet solana-keygen new --outfile ~/.config/solana/x402-demo.json solana config set --keypair ~/.config/solana/x402-demo.json solana config set --url devnet # Get wallet address SOLANA_WALLET=$(solana-keygen pubkey ~/.config/solana/x402-demo.json) echo "Wallet: $SOLANA_WALLET" # Fund wallet solana airdrop 2 solana balance # Test transaction solana transfer 0.01 # Verify on explorer # https://explorer.solana.com/?cluster=devnet ``` -------------------------------- ### Configure environment variables Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/README.md Copies the example environment file and lists required variables: ALLSOURCE_URL, SOLANA_WALLET, and OPENAI_API_KEY. ```bash # Copy example and fill in your values cp .env.example .env.local # Required variables: # - ALLSOURCE_URL # - SOLANA_WALLET # - OPENAI_API_KEY ``` -------------------------------- ### Run AllSource Core with Docker Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/introducing-allsource.mdx Starts the AllSource Core container locally, exposing port 3900. Requires Docker to be installed. ```bash # Docker docker run -p 3900:3900 ghcr.io/all-source-os/all-source:latest ``` -------------------------------- ### Useful make commands and demo script Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/QUICK_START.md Lists common make targets and the demo script. Includes make help, install, dev, clean, and running the demo script. ```bash # View all make targets make help # Install everything make install # Run all services (requires tmux or manually open 3 terminals) make dev # Clean all builds make clean # Run demo script (after services are running) ./demo-script.sh # Format code bun format ``` -------------------------------- ### Quick Start: Query DSL and Projection Server Source: https://github.com/all-source-os/all-source/blob/main/apps/query-service/README.md Shows the Query DSL usage with from_events/where/since/limit and starting a ProjectionServer. Requires importing QueryServiceEx.Application.DSL.QueryDSL. ```elixir # Query DSL import QueryServiceEx.Application.DSL.QueryDSL from_events() |> where(event_type: "order.placed") |> since(days_ago(7)) |> limit(100) # Projections {:ok, pid} = ProjectionServer.start_link( projection: my_projection, entity_id: "user-123" ) ``` -------------------------------- ### Development setup commands Source: https://github.com/all-source-os/all-source/blob/main/sdks/python-client/README.md Commands to install the package in editable mode with development dependencies, run tests with pytest, and type-check with mypy. ```bash pip install -e ".[dev]" pytest mypy src/ ``` -------------------------------- ### Create AllSource client with API key Source: https://github.com/all-source-os/all-source/blob/main/sdks/go/README.md Initializes a client using an API key from the environment and the default API endpoint. ```go client := allsource.New(os.Getenv("ALLSOURCE_API_KEY"), "https://api.all-source.xyz") ``` -------------------------------- ### GET /api/v1/embeddings/reprocess/{job_id} - Get Reprocessing Job Status Source: https://github.com/all-source-os/all-source/blob/main/docs/roadmaps/FUTURE_VECTOR_EMBEDDING_DESIGN.md Retrieves the status of a reprocessing job by its job ID. The response includes the job ID, status, progress with processed and total counts, percentage, start time, estimated completion, and any errors. ```http GET /api/v1/embeddings/reprocess/reprocess-550e8400 Authorization: Bearer ``` ```json { "job_id": "reprocess-550e8400", "status": "running", "progress": { "processed": 8500, "total": 15000, "percentage": 56.67 }, "started_at": "2025-11-04T12:00:00Z", "estimated_completion": "2025-11-04T12:45:00Z", "errors": [] } ``` -------------------------------- ### Funnel Analysis Tool Schema and Usage Source: https://github.com/all-source-os/all-source/blob/main/docs/MCP_SERVER_ENHANCEMENT_PLAN.md Defines the input schema for the 'funnel_analysis' tool and shows an example invocation with a signup funnel. The schema requires 'funnel_name' and 'steps', with optional 'time_window_ms' and 'since'. The example uses a 24-hour window and a specific start date. ```typescript { name: 'funnel_analysis', description: 'Analyze conversion funnels with multiple steps and time windows.', inputSchema: { type: 'object', properties: { funnel_name: { type: 'string' }, steps: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, event_type: { type: 'string' }, order: { type: 'number' } } } }, time_window_ms: { type: 'number', description: 'Maximum time between steps in milliseconds' }, since: { type: 'string' } }, required: ['funnel_name', 'steps'] } } ``` ```typescript // Example usage: { "funnel_name": "signup_funnel", "steps": [ {"name": "visit", "event_type": "page.view", "order": 1}, {"name": "signup", "event_type": "user.signup", "order": 2}, {"name": "activation", "event_type": "user.activated", "order": 3} ], "time_window_ms": 86400000, // 24 hours "since": "2025-10-01T00:00:00Z" } ``` -------------------------------- ### Run New Main File Source: https://github.com/all-source-os/all-source/blob/main/apps/control-plane/README.md Run the new v1.0 application entry point instead of the deprecated main.go. ```bash go run main_v1.go # Instead of main.go ``` -------------------------------- ### Analyze and start projection replay Source: https://github.com/all-source-os/all-source/blob/main/sdks/go/README.md Shows how to preview replay impact, start a replay if ready, and monitor progress. Requires a projection name. ```go analysis, err := client.AnalyzeProjectionReplay(ctx, "event-count") if err != nil { log.Fatal(err) } if analysis.ReadyToReplay && analysis.TotalEvents > 0 { run, err := client.StartProjectionReplay(ctx, analysis.ProjectionName) if err != nil { log.Fatal(err) } progress, err := client.GetProjectionReplay(ctx, run.ReplayID) fmt.Printf("%.1f%%\n", progress.ProgressPercentage) } ``` -------------------------------- ### Development Commands Source: https://github.com/all-source-os/all-source/blob/main/apps/query-service/README.md Common Mix commands for dependency installation, running tests, starting the Phoenix server on port 3902, and opening an interactive shell. ```bash # Install dependencies mix deps.get # Run tests mix test # Start server (port 3902) mix phx.server # Interactive shell iex -S mix ``` -------------------------------- ### Create SDK package directory Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/HACKATHON_CHECKLIST.md Navigate to the packages directory and create the x402-solana-sdk package directory. ```bash cd packages mkdir x402-solana-sdk cd x402-solana-sdk ``` -------------------------------- ### Run Lifecycle Events JSON Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/crash-safe-agents-write-before-execute.mdx Example run lifecycle events: agent.run.started and agent.run.completed. These events allow querying AllSource for runs that started but never completed, useful for monitoring. ```json { "event_type": "agent.run.started", "entity_id": "run-abc123", "payload": { "agent_id": "...", "trigger": "user" } } { "event_type": "agent.run.completed", "entity_id": "run-abc123", "payload": { "duration_ms": 4201 } } ``` -------------------------------- ### Run event_store_restart_proof example Source: https://github.com/all-source-os/all-source/blob/main/docs/evidence/2026-09-23-evidence-led-investigation.md Command executed from the AllSource repository on 23 September UTC. It runs the event_store_restart_proof example with embedded features and no default features, using RUSTC_WRAPPER set to empty. Exit code was 0, and append and replay both yielded stock 8; historical state after event 2 was 7. ```text env RUSTC_WRAPPER= cargo run -p allsource-core --no-default-features --features embedded --example event_store_restart_proof ``` -------------------------------- ### Shot 2: Solution - WordPress Plugin and Widget Script Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/SAAS_STRATEGY.md Script for the second shot, introducing the AllSource Paywall plugin. Includes installation steps, a shortcode example, and an HTML script tag for the widget. ```plaintext [Screen: WordPress with AllSource Paywall plugin] "Introducing AllSource Paywall. Add micropayments to any blog in 2 minutes." [Show installation:] 1. Install plugin 2. Add shortcode: [allsource-paywall price="0.50"] 3. Done [Show code simplicity] "Works on WordPress, Ghost, even Substack via extension." ``` -------------------------------- ### Get AllSource API Key via curl Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/event-sourcing-ai-agent-memory-guide.mdx Use this curl command to obtain an API key and tenant ID for AllSource. It starts a 14-day trial and requires an email and name in the JSON payload. ```bash curl -X POST https://api.all-source.xyz/api/v1/onboard/start \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com","name":"My Agent"}' ``` -------------------------------- ### Batch started events with POST /api/v1/events/batch Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/crash-safe-agents-write-before-execute.mdx Use this HTTP request to batch multiple 'agent.tool_call.started' events into a single round-trip, reducing overhead for high-frequency tools. The example shows two events with the same entity_id 'run-abc123'. ```bash POST /api/v1/events/batch { "events": [ { "event_type": "agent.tool_call.started", "entity_id": "run-abc123", ... }, { "event_type": "agent.tool_call.started", "entity_id": "run-abc123", ... } ] } ``` -------------------------------- ### Replay events leading to corrupted state Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/why-event-sourcing-2026.mdx Used for debugging complex systems by replaying events that led to a corrupted state. The example shows a GET request to fetch events for an order since a specific timestamp. ```bash # Replay the events that led to the corrupted state GET /api/v1/entities/order-789/events?since=2026-02-10T00:00:00Z ``` -------------------------------- ### Run x402 setup script Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/BATTLE_PLAN.md Command to execute the setup script for the hackathon environment. Run this as the next action after completing the pre-flight checklist. ```bash ./scripts/x402-setup.sh ``` -------------------------------- ### Health check gate output Source: https://github.com/all-source-os/all-source/blob/main/tooling/e2e/docs/E2E_TEST_STATUS.md Example output from the global setup that verifies all required services are healthy before running tests. Shows the Web App, Control Plane, Core, and Query Service health checks. ```text ðŸĨ Checking service health before running tests... ✅ Web App https://all-source.xyz/ — healthy (200) ✅ Control Plane http://localhost:3901/health — healthy (200) ✅ Core http://localhost:3280/health — healthy (200) ✅ Query Service http://localhost:3283/api/health — healthy (200) ``` -------------------------------- ### Create SDK source directory structure Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/HACKATHON_CHECKLIST.md Create the src directory and placeholder files for the SDK. ```bash mkdir -p src touch src/index.ts src/types.ts src/allsource.ts src/solana.ts src/middleware.ts ``` -------------------------------- ### Production setup environment variables Source: https://github.com/all-source-os/all-source/blob/main/docs/current/AUTH_CHAIN.md Bash commands showing recommended environment variable settings for Core and Query Service in production. ```bash # Core ALLSOURCE_BOOTSTRAP_API_KEY=ask_your-production-key ALLSOURCE_BOOTSTRAP_TENANT_ID=your-tenant ALLSOURCE_DATA_DIR=/data/events ALLSOURCE_DEV_MODE=false JWT_SECRET=your-shared-secret # Query Service CORE_URL=http://core:3900 CORE_API_KEY=ask_your-production-key JWT_SECRET=your-shared-secret ``` -------------------------------- ### Verify restart persistence with two processes Source: https://github.com/all-source-os/all-source/blob/main/integrations/langgraph-checkpoint-allsource/README.md Run two separate processes against one thread to verify restart persistence. First install the example dependencies, then run the write and read scripts with the ALLSOURCE_API_KEY environment variable. ```bash pip install -e '.[example]' ALLSOURCE_API_KEY=as_... python examples/restart_roundtrip.py write ALLSOURCE_API_KEY=as_... python examples/restart_roundtrip.py read ``` -------------------------------- ### Query medication change events for a patient Source: https://github.com/all-source-os/all-source/blob/main/apps/web/content/why-event-sourcing-2026.mdx Used for compliance and audit scenarios to retrieve the complete history of changes to a patient's medication. The example shows a GET request to the events endpoint, filtering by entity ID and event type. ```bash # Who changed this patient's medication and when? GET /api/v1/entities/patient-456/events?type=MedicationChanged ``` -------------------------------- ### Development Commands Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/README.md Commands to start the SDK development, run the demo app, run the dashboard, and build all packages. ```bash # Start SDK development cd packages/x402-solana-sdk bun run dev # Run demo app cd apps/x402-demo bun run dev # Run dashboard cd apps/x402-dashboard bun run dev # Build all packages bun run build ``` -------------------------------- ### Health endpoint responses (writable vs degraded) Source: https://github.com/all-source-os/all-source/blob/main/docs/runbooks/PRIME_MULTI_TENANT_INGEST.md GET /health returns HTTP 200 for both states. A writable writer returns status ok with writable true; a replica returns degraded with writable false and a reason. Both responses are shown as JSON examples. ```json {"status": "ok", "writable": true} {"status": "degraded", "writable": false, "reason": "another process owns the Prime data dir; ..."} ``` -------------------------------- ### Agent workflow with --toon flag Source: https://github.com/all-source-os/all-source/blob/main/apps/chronis/docs/BEST_PRACTICES.md Example of using --toon on every command for AI agent consumption. Sets CN_AGENT_ID and uses cn ready, cn claim, and cn done with --toon to get compact pipe-delimited output. ```bash # Agent workflow — every command uses --toon export CN_AGENT_ID=agent-1 cn ready --toon # [id|type|title|pri|status|claimed|blocked_by|parent|archived] cn claim t-abc1 --toon # ok:claimed:t-abc1 cn done t-abc1 --toon # ok:done:t-abc1 ``` -------------------------------- ### Install allsource-prime via Homebrew Source: https://github.com/all-source-os/all-source/blob/main/docs/VISION.md Installs the allsource-prime binary using Homebrew. This is the first step in adopting Prime for agent memory. ```bash brew install allsource-prime ``` -------------------------------- ### Open Documentation Files Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/BATTLE_PLAN.md Opens the main checklist, quick reference, and progress tracker documents for review. ```bash # Read the main checklist open docs/x402/HACKATHON_CHECKLIST.md # Print the quick reference open docs/x402/QUICK_REFERENCE.md # Have progress tracker ready open docs/x402/PROGRESS_TRACKER.md ``` -------------------------------- ### S2 Self-Host Welcome Email Body Source: https://github.com/all-source-os/all-source/blob/main/docs/marketing/lifecycle-email-trail.md Plain-text email body for self-host installers, sent out-of-band (not by this system). Includes links to MCP docs and GitHub Discussions, and mentions hosted pricing starting at $19/mo. Uses comms-system variables like {{mcp_docs_url}} and {{discussions_url}}. ```text You cloned AllSource and you're running it on your own hardware — unlimited events, forever retention, full MCP, zero dollars. That's the deal, and it stays the deal. Two things that save people time: - The 43 MCP tools drop straight into Claude Desktop. Wiring guide: {{mcp_docs_url}} - Stuck? GitHub Discussions is where I actually answer: {{discussions_url}} If you outgrow a single box and want us to run it, hosted starts at $19/mo (Indie). No pressure — self-host is a first-class tier, not a trial. — Decebal ``` -------------------------------- ### Step 1: Add Clojure Client - Install dependencies and create class Source: https://github.com/all-source-os/all-source/blob/main/docs/MCP_SERVER_ENHANCEMENT_PLAN.md Commands to install axios and zod dependencies and create the ClojureQueryClient class. This is the first step in the migration plan. ```bash # Install dependencies cd packages/mcp-server bun add axios zod # Create ClojureQueryClient class # Implement basic query, projection, analytics tools ``` -------------------------------- ### Run voice-demo with optional environment overrides Source: https://github.com/all-source-os/all-source/blob/main/tooling/voice-demo/README.md Run the voice demo from the tooling/voice-demo directory. Optionally set FASTEMBED_CACHE_PATH to reuse the bench fastembed cache and PRIME_BIN to point at a specific binary. Requires allsource-prime >= 0.21.3. ```bash cd tooling/voice-demo python3 voice_demo.py # or point at a specific binary / reuse the bench fastembed cache: FASTEMBED_CACHE_PATH=../mammoth-bench/.fastembed_cache \ PRIME_BIN=~/.cargo/bin/allsource-prime python3 voice_demo.py ``` -------------------------------- ### Start Core Before Control Plane Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/TROUBLESHOOTING.md Ensure Core is started before the Control Plane. This command starts Core in the background, waits for initialization, then starts the Control Plane. ```bash # Start Core first, then Control Plane cd apps/core && cargo run --release & sleep 5 # Wait for Core to initialize cd apps/control-plane && go run main.go ``` -------------------------------- ### Initialize package with bun Source: https://github.com/all-source-os/all-source/blob/main/docs/x402/HACKATHON_CHECKLIST.md Initialize a new package using bun init with default options. ```bash bun init -y ``` -------------------------------- ### Install cargo-sort Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/QUALITY_GATES_SETUP.md Installs the cargo-sort tool if not already installed. Required for the make format-sort command. ```bash cargo install cargo-sort ``` -------------------------------- ### Install allsource-mcp with cargo install Source: https://github.com/all-source-os/all-source/blob/main/docs/guides/ALLSOURCE_MCP.md Installs the allsource-mcp binary from crates.io. Requires Rust 1.92+. ```bash cargo install allsource-mcp ``` -------------------------------- ### Start MCP Server with Mix Source: https://github.com/all-source-os/all-source/blob/main/apps/mcp-server-elixir/README.md Commands to fetch dependencies and run the MCP server without halting. ```bash cd apps/mcp-server-elixir mix deps.get mix run --no-halt ``` -------------------------------- ### Install mammoth via cargo and curl Source: https://github.com/all-source-os/all-source/blob/main/docs/social/mammoth-launch-x-thread.md Install mammoth using cargo and a curl script. The cargo command installs the allsource-prime package, and the curl command runs the installation script for the mammoth plugin. ```bash cargo install allsource-prime curl -fsSL https://.../plugin/mammoth/install.sh | bash ``` -------------------------------- ### Sample output from prime_graph example Source: https://github.com/all-source-os/all-source/blob/main/README.md Example output from running the prime_graph example, showing graph structure and path information. ```text $ cargo run --features prime --example prime_graph Graph: 3 nodes, 3 edges Project team: Alice (person), Bob (person) Bob mentors: Alice Path Alice → Bob: 2 hops Alice's 2-hop subgraph: 3 nodes, 3 edges ``` -------------------------------- ### Install Playwright browsers Source: https://github.com/all-source-os/all-source/blob/main/tooling/e2e/README.md Command to install Playwright browsers when they are not found. ```bash bunx playwright install ```