{"id":38047232,"url":"https://github.com/adainthelab/the-human-pattern-lab-cli","last_synced_at":"2026-01-16T20:00:11.645Z","repository":{"id":330877944,"uuid":"1124254147","full_name":"AdaInTheLab/the-human-pattern-lab-cli","owner":"AdaInTheLab","description":"An AI-forward, automation-safe CLI for The Human Pattern Lab.","archived":false,"fork":false,"pushed_at":"2026-01-13T19:10:34.000Z","size":177,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T21:37:18.267Z","etag":null,"topics":["ai","ai-agents","ai-assistant","cli"],"latest_commit_sha":null,"homepage":"https://thehumanpatternlab.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdaInTheLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-28T16:55:36.000Z","updated_at":"2026-01-13T19:04:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AdaInTheLab/the-human-pattern-lab-cli","commit_stats":null,"previous_names":["adainthelab/the-human-pattern-lab-cli"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/AdaInTheLab/the-human-pattern-lab-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaInTheLab%2Fthe-human-pattern-lab-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaInTheLab%2Fthe-human-pattern-lab-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaInTheLab%2Fthe-human-pattern-lab-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaInTheLab%2Fthe-human-pattern-lab-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdaInTheLab","download_url":"https://codeload.github.com/AdaInTheLab/the-human-pattern-lab-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdaInTheLab%2Fthe-human-pattern-lab-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28482208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-assistant","cli"],"created_at":"2026-01-16T20:00:10.396Z","updated_at":"2026-01-16T20:00:11.636Z","avatar_url":"https://github.com/AdaInTheLab.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  HPL CLI\n  The Human Pattern Lab\n\n  This README is written for humans.\n  Design rationale lives in DESIGN.md.\n--\u003e\n\n# HPL CLI (Alpha) 🧭🦊\n\n![AI-Forward CLI](https://img.shields.io/badge/AI--Forward%20CLI-black?style=flat-square)\n![automation-safe by design](https://img.shields.io/badge/automation--safe%20by%20design-8b5cf6?style=flat-square)\n![npm (alpha)](https://img.shields.io/npm/v/@thehumanpatternlab/hpl/alpha?label=alpha\u0026color=8b5cf6\u0026style=flat-square)\n![Carmel Judgment](https://github.com/AdaInTheLab/the-human-pattern-lab-cli/actions/workflows/carmel-judgment.yml/badge.svg)\n\n\u003e **Status:** Alpha  \n\u003e A modern, automation-safe CLI for The Human Pattern Lab.\n\n**HPL** is the official command-line interface for **The Human Pattern Lab**.\n\nFormerly developed under the codename **Skulk**, HPL is built to work just as well for humans at the keyboard as it does for automation, CI, and agent-driven workflows.\n\nThis package is in **active alpha development**. Interfaces are stabilizing, but iteration is expected.\n\n---\n\n## What HPL Connects To\n\nHPL is a deterministic bridge between:\n\n- the **Human Pattern Lab Content Repository** (source of truth)\n- the **Human Pattern Lab API** (runtime index and operations)\n\nWritten content lives as Markdown in a dedicated content repository.  \nThe API syncs and indexes that content so it can be rendered by user interfaces.\n\nBy default, HPL targets a Human Pattern Lab API instance. You can override the API endpoint with `--base-url` to use staging or a self-hosted deployment of the same API.\n\n\u003e Note: `--base-url` is intended for alternate deployments of the Human Pattern Lab API, not arbitrary third-party APIs.\n\n---\n\n## Authentication\n\nHPL supports token-based authentication via the `HPL_TOKEN` environment variable.\n\n```bash\nexport HPL_TOKEN=\"your-api-token\"\n```\n\n(Optional) Override the API endpoint:\n\n```bash\nexport HPL_BASE_URL=\"https://api.thehumanpatternlab.com\"\n```\n\n\u003e `HPL_BASE_URL` should point to the **root** of a Human Pattern Lab API deployment.  \n\u003e Do not include additional path segments.\n\nSome API endpoints may require authentication depending on server configuration.\n\n---\n\n## Quick Start\n\n### Install (alpha)\n\n```bash\nnpm install -g @thehumanpatternlab/hpl@alpha\n```\n\n### Sync Lab Notes from the content repository\n\n```bash\nhpl notes sync --content-repo AdaInTheLab/the-human-pattern-lab-content\n```\n\nThis pulls structured Markdown content from the repository and synchronizes it into the Human Pattern Lab system.\n\n### Machine-readable output\n\n```bash\nhpl --json notes sync\n```\n\n---\n\n## Content Source Configuration (Optional)\n\nBy default, `notes sync` expects a content repository with the following structure:\n\n```text\nlabnotes/\n  en/\n    *.md\n  ko/\n    *.md\n```\n\nYou may pin a default content repository using an environment variable:\n\n```bash\nexport HPL_CONTENT_REPO=\"AdaInTheLab/the-human-pattern-lab-content\"\n```\n\nThis allows `hpl notes sync` to run without explicitly passing `--content-repo`.\n\n---\n\n## Commands\n\n```text\nhpl \u003cdomain\u003e \u003caction\u003e [options]\n```\n\n### notes\n\n- `hpl notes list`\n- `hpl notes get \u003cslug\u003e`\n- `hpl notes sync --content-repo \u003cowner/name|url\u003e`\n- `hpl notes sync --dir \u003cpath\u003e` (advanced / local development)\n\n### health\n\n```bash\nhpl health\n```\n\n### version\n\n```bash\nhpl version\n```\n\n---\n\n## JSON Output Contract\n\nStructured output is treated as a **contract**, not a courtesy.\n\nWhen `--json` is provided:\n\n- stdout contains **only valid JSON**\n- stderr is used for logs and diagnostics\n- exit codes are deterministic\n\nA verification step is included:\n\n```bash\nnpm run json:check\n```\n\nThis command fails if any non-JSON output appears on stdout.\n\n---\n\n## What HPL Is Not\n\nHPL is not:\n- a chatbot interface\n- an agent framework\n- a memory system\n- an inference layer\n\nIt is a command-line tool for interacting with Human Pattern Lab systems in a predictable, human-owned way.\n\n---\n\n**The Human Pattern Lab**  \nhttps://thehumanpatternlab.com\n\n*The lantern is lit.  \nThe foxes are watching.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadainthelab%2Fthe-human-pattern-lab-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadainthelab%2Fthe-human-pattern-lab-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadainthelab%2Fthe-human-pattern-lab-cli/lists"}