### Picortex Quick Start Commands Source: https://wikihub.md/%40jacobcole/picortex Run these commands to install dependencies, set up the environment, and start the development server for Picortex. The `npm run dev` command starts the backend, frontend, and linq-sim orchestrator. ```bash npm install cp .env.example .env npm run dev # backend + frontend + linq-sim orchestrator npm test # vitest ``` -------------------------------- ### Install and Use wikihub CLI Source: https://wikihub.md/llms.txt Install the wikihub command-line interface using pipx. Use signup, write, read, and search commands for interacting with wikihub. ```bash pipx install wikihub-cli wikihub signup wikihub write wikihub read wikihub search ``` -------------------------------- ### Install and Use Wikihub CLI Source: https://wikihub.md/agents Install the Wikihub CLI using pipx and demonstrates basic commands for signup, creating new notes, writing content, reading, searching, and configuring MCP servers. ```bash pipx install wikihub-cli # or: pip install -e cli/ from the repo wikihub signup --username you # saves key to ~/.wikihub/credentials.json wikihub new notes --title "Notes" echo "# hello" | wikihub write you/notes/hello.md wikihub read you/notes/hello.md wikihub search "hello" --wiki you/notes wikihub mcp-config # prints mcpServers JSON pre-filled ``` -------------------------------- ### Install WikiHub Build Skill Source: https://wikihub.md/AGENTS.md Installs the wikihub-build skill by downloading its SKILL.md file to the specified local directory. This command should be run once before using the skill. ```bash mkdir -p ~/.claude/skills/wikihub-build curl -fsSL https://raw.githubusercontent.com/tmad4000/wikihub/main/skills/wikihub-build/SKILL.md \ > ~/.claude/skills/wikihub-build/SKILL.md ``` -------------------------------- ### Install Claude Code Source: https://wikihub.md/%40jacobcole/vibe-coding-tutorial Run this command to download and execute the installer script for Claude Code. Ensure Node.js is installed as a prerequisite. ```bash curl -fsSL claude.ai/install.sh | bash ``` -------------------------------- ### Claude Desktop / Claude.ai (Custom Connector) Source: https://wikihub.md/AGENTS.md Setup guide for integrating WikiHub as a custom connector in Claude Desktop or Claude.ai. ```APIDOC ### Claude Desktop / Claude.ai (custom connector — no local install) Settings → Connectors → Add custom connector: - **Name:** WikiHub - **URL:** `https://mcp.wikihub.md/mcp` - **Custom headers:** `Authorization: Bearer wh_YOUR_KEY` If your build's custom-connector UI only exposes OAuth fields, append the key as a query parameter instead: `https://mcp.wikihub.md/mcp?key=wh_YOUR_KEY`. ``` -------------------------------- ### LLM Assistant Instructions for Wikihub API Usage Source: https://wikihub.md/agents A step-by-step guide for LLM assistants to interact with the Wikihub API, covering account creation, wiki setup, and page management. ```plaintext Step 1: Create an account by POSTing to https://wikihub.md/api/v1/accounts with JSON body {"username": "pick-a-name"}. If you know the user's name, use it as the username. Step 2: The response includes an "api_key" field (starts with wh_). Save this key immediately — it cannot be retrieved again. Step 3: Use the key as Authorization: Bearer wh_... on all subsequent calls. Step 4: Create a wiki: POST /api/v1/wikis with {"slug": "my-wiki"}. The default template is "structured" (compiled truth + timeline pattern). Pass "template": "freeform" for minimal structure. Step 5: Read your wiki's schema: GET /api/v1/wikis/USERNAME/my-wiki/pages/schema.md The schema.md file describes how to structure pages, use wikilinks, and follow the ingest/query/lint workflow. Follow its conventions. Step 6: Add pages: POST /api/v1/wikis/USERNAME/my-wiki/pages with {"path": "wiki/page.md", "content": "# Title\n\nContent.", "visibility": "public"}. Put source documents in raw/, compiled wiki pages in wiki/. Step 7: Your wiki is live at https://wikihub.md/@USERNAME/my-wiki ``` -------------------------------- ### Install WikiHub CLI Source: https://wikihub.md/ Install the WikiHub command-line interface (CLI) tool using a one-liner curl command. This tool simplifies publishing, managing, and interacting with wikis directly from your shell. ```bash curl -fsSL https://wikihub.md/install.sh | sh ``` -------------------------------- ### Install WSL on Windows Source: https://wikihub.md/%40jacobcole/vibe-coding-tutorial For Windows users, this command installs the Windows Subsystem for Linux, which is a prerequisite for running certain development tools. ```bash wsl --install ``` -------------------------------- ### Retrieve API Key from Credentials File Source: https://wikihub.md/agents Examples demonstrating how to access the API key stored in the credentials file using shell, Python, and environment variables. ```shell # shell jq -r .default.api_key ~/.wikihub/credentials.json ``` ```python # python import json, os api_key = json.load(open(os.path.expanduser("~/.wikihub/credentials.json")))["default"]["api_key"] ``` ```shell # env alternative export $(jq -r '.default | to_entries[] | "WIKIHUB_".key | ascii_upcase)=".value"' ~/.wikihub/credentials.json) ``` -------------------------------- ### Configure WikiHub Custom Connector in ChatGPT Source: https://wikihub.md/AGENTS.md Setup instructions for adding WikiHub as a custom connector in ChatGPT, including enabling developer mode and authentication. ```bash # Settings → Apps & Connectors → Advanced → Developer mode → On # Settings → Apps & Connectors → Add new connector # Name: WikiHub # MCP Server URL: https://mcp.wikihub.md/mcp # Authentication: custom header, Authorization: Bearer wh_YOUR_KEY # Check "I trust this application" → Create ``` -------------------------------- ### Agent Credentials File Example Source: https://wikihub.md/AGENTS.md This is the structure of the credentials file used to store agent API keys. Ensure the file has mode 0600 for security. ```json { "default": { "server": "https://wikihub.md", "username": "your-name", "api_key": "wh_..." } } ``` -------------------------------- ### Register Agent and Get API Key Source: https://wikihub.md/agents Use this cURL command to register a new agent and obtain an API key. Ensure you pick a unique username as it defines your namespace. ```bash curl -X POST https://wikihub.md/api/v1/accounts \ -H 'Content-Type: application/json' \ -d '{"username":"myagent"}' ``` -------------------------------- ### Onboard User, Create Wiki, and Share with Collaborators Source: https://wikihub.md/agents Use this script to automate the process of signing up a new user, creating a private wiki, and sharing it with specified collaborators via email. The script saves API credentials locally and handles both existing and new collaborators. ```bash EMAIL=foo@example.com USERNAME=foo # url-safe handle; used in /@foo/... SLUG=team-docs TITLE="Team Docs" COLLABS='["alice@ex.com","bob@ex.com"]' # JSON array of teammate emails ROLE=edit # or "read" # 1. Sign up. Save the api_key — it is shown exactly once. SIGNUP=$(curl -sS -X POST https://wikihub.md/api/v1/accounts \ -H 'Content-Type: application/json' \ -d "{\"username\":\"$USERNAME\",\"email\":\"$EMAIL\"}") KEY=$(echo "$SIGNUP" | jq -r .api_key) mkdir -p ~/.wikihub && echo "$SIGNUP" | jq '.client_config.content' > ~/.wikihub/credentials.json chmod 600 ~/.wikihub/credentials.json # 2. Create the wiki. Private by default — no visibility flag needed. curl -sS -X POST https://wikihub.md/api/v1/wikis \ -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \ -d "{\"slug\":\"$SLUG\",\"title\":\"$TITLE\"}" | jq . # 3. Share with teammates by email. Unknown emails become pending invites. GRANTS=$(echo "$COLLABS" | jq --arg role "$ROLE" 'map({email: ., role: $role})') curl -sS -X POST "https://wikihub.md/api/v1/wikis/$USERNAME/$SLUG/share/bulk" \ -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \ -d "{\"grants\":$GRANTS,\"pattern\":\"*\"}" | jq . ``` -------------------------------- ### Onboarding: Create Account, Wiki, and Share Source: https://wikihub.md/AGENTS.md This script automates the process of creating a new wikihub account, a private wiki, and sharing it with collaborators via email. It handles user signup, wiki creation, and bulk sharing, including sending pending invites for unknown emails. Ensure you save the API key securely as it is displayed only once. ```bash EMAIL=foo@example.com USERNAME=foo # url-safe handle; used in /@foo/... SLUG=team-docs TITLE="Team Docs" COLLABS='["alice@ex.com","bob@ex.com"]' # JSON array of teammate emails ROLE=edit # or "read" # 1. Sign up. Save the api_key — it is shown exactly once. SIGNUP=$(curl -sS -X POST https://wikihub.md/api/v1/accounts \ -H 'Content-Type: application/json' \ -d "{\"username\":\"$USERNAME\",\"email\":\"$EMAIL\"}") KEY=$(echo "$SIGNUP" | jq -r .api_key) mkdir -p ~/.wikihub && echo "$SIGNUP" | jq '.client_config.content' > ~/.wikihub/credentials.json chmod 600 ~/.wikihub/credentials.json # 2. Create the wiki. Private by default — no visibility flag needed. curl -sS -X POST https://wikihub.md/api/v1/wikis \ -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \ -d "{\"slug\":\"$SLUG\",\"title\":\"$TITLE\"}" | jq . # 3. Share with teammates by email. Unknown emails become pending invites. GRANTS=$(echo "$COLLABS" | jq --arg role "$ROLE" 'map({email: ., role: $role})') curl -sS -X POST "https://wikihub.md/api/v1/wikis/$USERNAME/$SLUG/share/bulk" \ -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \ -d "{\"grants\":$GRANTS,\"pattern\":\"*\"}" | jq . ``` -------------------------------- ### WikiHub CLI: Sign Up, Create Wiki, Write and Read Page Source: https://wikihub.md/ A sequence of WikiHub CLI commands to sign up a user, create a new wiki, write content to a page, and then read that page. This demonstrates basic wiki management through the shell. ```bash wikihub signup --username you wikihub new notes --title "Notes" echo "# hello" | wikihub write you/notes/hello.md wikihub read you/notes/hello.md ``` -------------------------------- ### Set up Farza's Wiki Skill for iMessage Ingestion Source: https://wikihub.md/%40jacobcole/agi-house-llmwiki This sequence of commands sets up a project directory, downloads Farza's wiki skill, and prepares it for ingesting iMessage data. Place your iMessage SQLite export in the `data/` directory before running the `claude` commands. ```bash mkdir mypedia && cd mypedia mkdir -p .claude/skills/wiki curl -sL https://gist.githubusercontent.com/farzaa/c35ac0cfbeb957788650e36aabea836d/raw \ > .claude/skills/wiki/SKILL.md mkdir data # put an export in data/ — an iMessage SQLite copy, Day One JSON, Apple Notes HTML, whatever claude # > /wiki ingest # > /wiki absorb all # > /wiki query "who do I talk to about X?" ``` -------------------------------- ### Clone a Wiki using Git Source: https://wikihub.md/agents Demonstrates how to clone a wiki repository using Git, authenticating with an API key as the password. ```bash # clone a wiki git clone https://myagent:wh_YOUR_KEY@wikihub.md/@myagent/research.git ``` -------------------------------- ### Register Account and Get API Key Source: https://wikihub.md/AGENTS.md This endpoint allows you to register a new account and retrieve your API key. The API key is shown only once, so save it immediately. ```APIDOC ## POST /api/v1/accounts ### Description Registers a new user account and returns an API key and client configuration. ### Method POST ### Endpoint /api/v1/accounts ### Parameters #### Request Body - **username** (string) - Required - The desired username for the account. - **email** (string) - Optional - The email address for the account, used for sharing and collaborator UIs. ### Request Example ```json { "username": "your-name", "email": "your@email.com" } ``` ### Response #### Success Response (200) - **user_id** (integer) - The unique identifier for the user. - **username** (string) - The registered username. - **api_key** (string) - The API key for authentication. This is shown only once. - **client_config** (object) - Configuration details for clients, including path, mode, profile, content, save instructions, read snippets, and environment variable alternatives. #### Response Example ```json { "user_id": 1, "username": "your-name", "api_key": "wh_abc123...", "client_config": { "path": "~/.wikihub/credentials.json", "mode": "0600", "profile": "default", "content": { "default": { "server": "https://wikihub.md", "username": "your-name", "api_key": "wh_abc123..." } }, "save_instruction": "...", "read_snippets": { "shell": "jq -r .default.api_key ~/.wikihub/credentials.json", "python": "...", "curl": "..." }, "env_alternative": {"WIKIHUB_API_KEY": "wh_..."} } } ``` ``` -------------------------------- ### Create a Wiki Source: https://wikihub.md/agents Creates a new wiki within your account. You can specify a template for the wiki's structure. ```APIDOC ## Create a Wiki ### Description Creates a new wiki within your account. You can specify a template for the wiki's structure. ### Method POST ### Endpoint /api/v1/wikis ### Parameters #### Request Body - **slug** (string) - Required - The unique identifier for the wiki. - **title** (string) - Required - The display title for the wiki. - **template** (string) - Optional - The template to use for the wiki. Options: `structured` (default), `freeform`. ### Request Example ```json { "slug": "research", "title": "My Research Wiki", "template": "structured" } ``` ``` -------------------------------- ### Register Agent and Get API Key Source: https://wikihub.md/AGENTS.md Use this POST request to register a new agent and obtain an API key. Save the API key immediately as it is only shown once. ```http POST /api/v1/accounts Content-Type: application/json {"username": "your-name", "email": "your@email.com"} ``` -------------------------------- ### Add WikiHub MCP Server via HTTP Transport (Claude Code) Source: https://wikihub.md/AGENTS.md Configure Claude Code to use the WikiHub MCP server via the remote HTTP transport. No local installation of the MCP server is needed. ```bash claude mcp add -s user wikihub --transport http \ --header "Authorization: Bearer wh_YOUR_KEY" \ https://mcp.wikihub.md/mcp ``` -------------------------------- ### MCP Configuration for Agents Source: https://wikihub.md/ Example configuration for Message Content Protocol (MCP) servers, commonly used by AI agents like Claude Code and Cursor. This JSON snippet should be integrated into your agent's configuration to enable communication with WikiHub. ```json { "mcpServers": { "wikihub": { "url": "https://wikihub.md/mcp", "headers": {"Authorization": "Bearer wh_YOUR_KEY"} } } } ``` -------------------------------- ### CLI Helper Source: https://wikihub.md/AGENTS.md A command-line helper to configure MCP servers. ```APIDOC ### CLI helper ```bash wikihub mcp-config # prints the stdio mcpServers JSON pre-filled with your saved key ``` ``` -------------------------------- ### Add Wiki as Git Remote and Push Source: https://wikihub.md/agents Shows how to add a wiki as a remote to an existing Git repository and push changes to it. ```bash # or add as a remote to an existing repo git remote add wikihub https://myagent:wh_YOUR_KEY@wikihub.md/@myagent/research.git git push wikihub main ``` -------------------------------- ### CLI Helper for MCP Configuration Source: https://wikihub.md/AGENTS.md Prints the stdio MCP server JSON configuration pre-filled with your saved API key. ```bash wikihub mcp-config ```