{"id":40482154,"url":"https://github.com/otoneko1102/nekos","last_synced_at":"2026-01-20T18:33:43.812Z","repository":{"id":312523664,"uuid":"1047776185","full_name":"otoneko1102/nekos","owner":"otoneko1102","description":"Let's have cute cats mess around in the log!","archived":false,"fork":false,"pushed_at":"2026-01-10T11:41:20.000Z","size":448,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T03:37:53.142Z","etag":null,"topics":["cat","cats","cli","log","neko","nekos"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/nekos","language":"JavaScript","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/otoneko1102.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":null,"dco":null,"cla":null}},"created_at":"2025-08-31T07:46:17.000Z","updated_at":"2026-01-10T11:40:37.000Z","dependencies_parsed_at":"2025-08-31T09:22:28.351Z","dependency_job_id":"6d7fd5e0-5436-482e-a491-7abb814f96bf","html_url":"https://github.com/otoneko1102/nekos","commit_stats":null,"previous_names":["otoneko1102/nekos"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/otoneko1102/nekos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otoneko1102%2Fnekos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otoneko1102%2Fnekos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otoneko1102%2Fnekos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otoneko1102%2Fnekos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/otoneko1102","download_url":"https://codeload.github.com/otoneko1102/nekos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otoneko1102%2Fnekos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28609121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"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":["cat","cats","cli","log","neko","nekos"],"created_at":"2026-01-20T18:33:41.837Z","updated_at":"2026-01-20T18:33:43.763Z","avatar_url":"https://github.com/otoneko1102.png","language":"JavaScript","funding_links":["https://www.buymeacoffee.com/devuloper","https://ko-fi.com/E1E41LY2C9'"],"categories":[],"sub_categories":[],"readme":"# nekos 🐱\n\n[![npm version](https://badge.fury.io/js/nekos.svg)](https://badge.fury.io/js/nekos)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)\n[![Validate AA Contribution](https://github.com/otoneko1102/nekos/actions/workflows/validate-aa.yml/badge.svg)](https://github.com/otoneko110/nekos/actions/workflows/validate-aa.yml)\n\n\u003ca href=\"https://www.buymeacoffee.com/devuloper\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\n\u003ca href='https://ko-fi.com/E1E41LY2C9' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\nA simple CLI tool to display cat ASCII art in your console.\n\n![sample](img/sample.png)\n\n## Install\n\n```bash\nnpm install nekos\n```\n\n## Usage\n\n```javascript\n// ESM\nimport nekos from \"nekos\";\n// CJS\nconst nekos = require(\"nekos\").default;\n\n// Log a random cat\nnekos();\n\n// Log a specific cat by ID\nnekos({ id: \"my_cat\" });\n\n// Log a cat with a rainbow gradient\nnekos({ colors: \"RAINBOW\" });\n\n// Log a cat with a single random color\nnekos({ colors: \"RANDOM\" });\n\n// Log a cat with a custom gradient\nnekos({ colors: [\"#ff00ff\", \"#00ffff\"] });\n\n// Log a specific cat with two random gradient colors\nnekos({ id: \"sad_cat\", colors: [\"RANDOM\", \"RANDOM\"] });\n```\n\n[ESM Example - demo.js](test/demo.js)  \n[CJS Example - demo.cjs](test/demo.cjs)\n\n---\n\n## CLI Usage\n\nFor command line use, either install the package globally or use `npx`.\n\n```bash\n# Install globally\nnpm install -g nekos\n```\n\n### Examples\n\n```bash\n# Display a random cat\nnekos\n\n# Display a specific cat by ID\nnekos --id my_cat\nnekos -i my_cat\n\n# Display a cat with a rainbow gradient\nnekos --colors RAINBOW\nnekos -c RAINBOW\n\n# Display a cat with two random gradient colors\nnekos --colors RANDOM RANDOM\nnekos -c RANDOM RANDOM\n\n# Display a specific cat with a custom gradient\nnekos --id sad_cat --colors \"#ff00ff\" \"#00ffff\"\nnekos -i sad_cat -c \"#ff00ff\" \"#00ffff\"\n\n# You can also use npx without a global installation\nnpx nekos --colors \"#ff00ff #00ffff\"\nnpx nekos -c \"#ff00ff\" \"#00ffff\"\n\n# Check the current version.\nnekos --version\nnekos -v\n```\n\n---\n\n## API\n\n`nekos(options)`\n\n### options\n\nType: `object`\n\n#### id\n\nType: `string`\n\nThe ID of the ASCII art to display (the filename without the `.txt` extension). If not provided, a random cat will be shown.\n\n#### colors\n\nType: `string | string[]`\n\nSpecify the color(s) for the ASCII art.\n\n- **String Keywords:**\n  - `'RANDOM'`: Applies a single random solid color.\n  - `'RAINBOW'`: Applies a rainbow gradient.\n- **String Array:** An array of color strings (e.g., hex codes, color names) to create a custom gradient.\n\n## Contributing\n\nContributions are welcome! Please see the [Contributing Guidelines](CONTRIBUTING.md) for more details.\n\n---\n\n## nekos 🐱 (日本語)\n\nコンソールに猫のアスキーアートを表示する、シンプルな CLI ツールです。\n\n## インストール\n\n```bash\nnpm install nekos\n```\n\n## 使い方\n\n```javascript\n// ESM\nimport nekos from \"nekos\";\n// CJS\nconst nekos = require(\"nekos\").default;\n\n// ランダムな猫を表示\nnekos();\n\n// IDを指定して特定の猫を表示\nnekos({ id: \"my_cat\" });\n\n// 虹色のグラデーションで猫を表示\nnekos({ colors: \"RAINBOW\" });\n\n// ランダムな単色で猫を表示\nnekos({ colors: \"RANDOM\" });\n\n// カスタムグラデーションで猫を表示\nnekos({ colors: [\"#ff00ff\", \"#00ffff\"] });\n\n// IDを指定した猫に、2色のランダムなグラデーションを適用\nnekos({ id: \"sad_cat\", colors: [\"RANDOM\", \"RANDOM\"] });\n```\n\n[ESM Example - demo.js](test/demo.js)  \n[CJS Example - demo.cjs](test/demo.cjs)\n\n---\n\n## コマンドラインでの使い方\n\nコマンドラインで使うには、パッケージをグローバルインストールするか、`npx`を利用します。\n\n```bash\n# グローバルインストール\nnpm install -g nekos\n```\n\n### 実行例\n\n```bash\n# ランダムな猫を表示\nnekos\n\n# IDを指定して特定の猫を表示\nnekos --id my_cat\nnekos -i\n\n# 虹色のグラデーションで猫を表示\nnekos --colors RAINBOW\nnekos -c RAINBOW\n\n# 2色のランダムなグラデーションで猫を表示\nnekos --colors RANDOM RANDOM\nnekos -c RANDOM RANDOM\n\n# IDを指定した猫にカスタムグラデーションを適用\nnekos --id sad_cat --colors \"#ff00ff\" \"#00ffff\"\nnekos -i sad_cat -c \"#ff00ff\" \"#00ffff\"\n\n# グローバルインストールなしでnpxを使っても実行できます\nnpx nekos --colors \"#ff00ff #00ffff\"\nnpx nekos -c \"#ff00ff\" \"#00ffff\"\n\n# 現在のバージョンを確認\nnekos --version\nnekos -v\n```\n\n---\n\n## API\n\n`nekos(options)`\n\n### options\n\n型: `object`\n\n#### id\n\n型: `string`\n\n表示したいアスキーアートの ID（`.txt`を除いたファイル名）。指定しない場合は、ランダムな猫が表示されます。\n\n#### colors\n\n型: `string | string[]`\n\nアスキーアートの色を指定します。\n\n- **文字列キーワード:**\n  - `'RANDOM'`: ランダムな単色を適用します。\n  - `'RAINBOW'`: 虹色のグラデーションを適用します。\n- **文字列配列:** カスタムグラデーションを作成するための色の配列（例: HEX コード、色名）。\n\n## コントリビューション\n\nコントリビューションを歓迎します！詳細は[コントリビューションガイドライン](CONTRIBUTING.md)をご覧ください。\n\n# Contributors\n\n[![Contributors](https://contrib.rocks/image?repo=otoneko1102/nekos)](https://github.com/otoneko1102/nekos/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotoneko1102%2Fnekos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fotoneko1102%2Fnekos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotoneko1102%2Fnekos/lists"}