{"id":47605992,"url":"https://github.com/halo-dev/cli","last_synced_at":"2026-04-01T19:22:46.089Z","repository":{"id":345476831,"uuid":"1185134263","full_name":"halo-dev/cli","owner":"halo-dev","description":"CLI for Halo","archived":false,"fork":false,"pushed_at":"2026-03-19T15:43:16.000Z","size":288,"stargazers_count":3,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-20T00:50:33.577Z","etag":null,"topics":["agent-skills","agents","halo","halo-cli","openclaw","skills"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/halo-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-18T09:18:40.000Z","updated_at":"2026-03-19T15:51:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/halo-dev/cli","commit_stats":null,"previous_names":["halo-dev/cli"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/halo-dev/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-dev%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-dev%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-dev%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-dev%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/halo-dev","download_url":"https://codeload.github.com/halo-dev/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halo-dev%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291127,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"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":["agent-skills","agents","halo","halo-cli","openclaw","skills"],"created_at":"2026-04-01T19:22:42.390Z","updated_at":"2026-04-01T19:22:46.083Z","avatar_url":"https://github.com/halo-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Halo CLI\n\n[简体中文](./README.zh-CN.md)\n\nA command-line tool for managing [Halo](https://www.halo.run) instances.\n\n\u003cp\u003e\n\u003ca href=\"https://www.npmjs.com/package/@halo-dev/cli\"\u003e\u003cimg alt=\"NPM Downloads\" src=\"https://img.shields.io/npm/dm/%40halo-dev%2Fcli\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/@halo-dev/cli\"\u003e\u003cimg alt=\"NPM Version\" src=\"https://img.shields.io/npm/v/%40halo-dev%2Fcli\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/@halo-dev/cli\"\u003e\u003cimg alt=\"NPM Last Update\" src=\"https://img.shields.io/npm/last-update/%40halo-dev%2Fcli\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n[![asciicast](https://asciinema.org/a/LiTFpF00sFMKnNGX.svg)](https://asciinema.org/a/LiTFpF00sFMKnNGX)\n\n## Install\n\n```sh\nnpm install -g @halo-dev/cli\n```\n\nThe installed binary is:\n\n```sh\nhalo\n```\n\nCheck the version:\n\n```sh\nhalo --version\n```\n\n## Requirements\n\n- Node.js `\u003e= 22`\n\n## Quick Start\n\n### Login with a bearer token\n\n```sh\nhalo auth login \\\n  --profile local \\\n  --url http://127.0.0.1:8090 \\\n  --auth-type bearer \\\n  --token \u003cyour-token\u003e\n```\n\n### Login with Basic Auth\n\nBefore using Basic Auth, make sure your Halo instance enables it.\n\nStart Halo with:\n\n```sh\n--halo.security.basic-auth.disabled=false\n```\n\nThen login:\n\n```sh\nhalo auth login \\\n  --profile local \\\n  --url http://127.0.0.1:8090 \\\n  --auth-type basic \\\n  --username admin \\\n  --password \u003cyour-password\u003e\n```\n\n### Verify the current profile\n\n```sh\nhalo auth current\nhalo auth profile list\n```\n\n## Common Usage\n\nGet help:\n\n```sh\nhalo --help\nhalo auth --help\nhalo post --help\nhalo single-page --help\n```\n\nExample root help output:\n\n```text\nhalo/1.0.0\n\nUsage:\n  $ halo \u003ccommand\u003e [options]\n\nCommands:\n  auth          Authentication commands\n  post          Post management commands\n  single-page   Single page management commands\n  search        Search public site content\n  plugin        Plugin management commands\n  theme         Theme management commands\n  attachment    Attachment management commands\n  backup        Backup management commands\n  moment        Moment management commands\n  comment       Comment management commands\n  notification  Notification management commands\n\nFor more info, run any command with the `--help` flag:\n  $ halo auth --help\n  $ halo post --help\n  $ halo single-page --help\n  $ halo search --help\n  $ halo plugin --help\n  $ halo theme --help\n  $ halo attachment --help\n  $ halo backup --help\n  $ halo moment --help\n  $ halo comment --help\n  $ halo notification --help\n\nOptions:\n  -h, --help     Display this message\n  -v, --version  Display version number\n```\n\nUse a specific saved profile:\n\n```sh\nhalo post list --profile production\n```\n\nUse JSON output for scripting:\n\n```sh\nhalo post list --json\nhalo single-page get about --json\n```\n\nEnable shell completion:\n\nFor `bash`:\n\n```sh\neval \"$(halo completion bash)\"\n```\n\nFor `zsh`:\n\n```sh\neval \"$(halo completion zsh)\"\n```\n\nAfter enabling completion, you can use \u003ckbd\u003eTab\u003c/kbd\u003e to complete commands such as:\n\n```sh\nhalo \u003cTAB\u003e\nhalo auth \u003cTAB\u003e\nhalo comment reply \u003cTAB\u003e\n```\n\n## Main Command Areas\n\nHalo CLI currently includes these command groups:\n\n- `auth`\n- `post`\n- `single-page`\n- `search`\n- `plugin`\n- `theme`\n- `attachment`\n- `backup`\n- `moment`\n- `comment`\n- `notification`\n\nFor details on any command, use `--help`.\n\n## Agent Skills\n\nThis package also ships with reusable skills under the root `skills/` directory.\n\nIncluded skills:\n\n- `halo-cli`\n- `halo-cli-shared`\n- `halo-cli-auth`\n- `halo-cli-content`\n- `halo-cli-search`\n- `halo-cli-operations`\n- `halo-cli-moderation-notifications`\n\nAdd the skills with:\n\n```sh\nnpx skills add halo-dev/cli\n```\n\nRecommended starting point after installation:\n\n```sh\nskills/halo-cli/SKILL.md\n```\n\n## Configuration\n\nProfile metadata is stored in:\n\n- `$HALO_CLI_CONFIG_DIR/config.json` if `HALO_CLI_CONFIG_DIR` is set\n- otherwise `$XDG_CONFIG_HOME/halo/config.json`\n- otherwise `~/.config/halo/config.json`\n\nCredentials are stored in the system keyring.\n\n## Development\n\nUseful commands:\n\n```sh\npnpm typecheck\nvp lint\nvp test\nvp pack\n```\n\n## Publishing\n\nBefore publishing, verify the package contents:\n\n```sh\nnpm pack --dry-run\n```\n\nCreate a release version locally without publishing to npm:\n\n```sh\nvp run release\nvp run release:dry\n```\n\nThis uses `release-it` to bump the version, create a release commit and git tag, push them upstream, and create a GitHub Release.\nIt does not publish the package to npm.\n\nThe published package should include:\n\n- `dist/`\n- `skills/`\n- `README.md`\n- `LICENSE`\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalo-dev%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhalo-dev%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalo-dev%2Fcli/lists"}