{"id":28407617,"url":"https://github.com/jschwind/phpcli-ai","last_synced_at":"2026-05-01T00:31:36.002Z","repository":{"id":295975512,"uuid":"991854724","full_name":"jschwind/phpcli-ai","owner":"jschwind","description":"Generate a text-based dump of source files or a directory tree structure, suitable for AI processing.","archived":false,"fork":false,"pushed_at":"2025-08-26T12:26:16.000Z","size":81,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-26T16:02:19.538Z","etag":null,"topics":["ai","dump","dumper","php","php8","shell","shell-script"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/jschwind.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}},"created_at":"2025-05-28T08:47:44.000Z","updated_at":"2025-08-26T12:26:19.000Z","dependencies_parsed_at":"2025-06-12T13:22:10.752Z","dependency_job_id":"c6894a48-6f54-4746-abc9-1ae801e9d5dd","html_url":"https://github.com/jschwind/phpcli-ai","commit_stats":null,"previous_names":["jschwind/phpcli-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jschwind/phpcli-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschwind%2Fphpcli-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschwind%2Fphpcli-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschwind%2Fphpcli-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschwind%2Fphpcli-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jschwind","download_url":"https://codeload.github.com/jschwind/phpcli-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jschwind%2Fphpcli-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32481553,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"ssl_error","status_checked_at":"2026-04-30T13:12:06.837Z","response_time":57,"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","dump","dumper","php","php8","shell","shell-script"],"created_at":"2025-06-02T01:30:24.114Z","updated_at":"2026-05-01T00:31:35.968Z","avatar_url":"https://github.com/jschwind.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PHPCLI-AI\n\nA CLI tool that generates a text-based dump of source files or a directory tree structure — ideal for processing by AI systems.\n\n## 🔧 Installation\n\n```bash\ngit clone https://github.com/jschwind/phpcli-ai.git\ncd phpcli-ai\nchmod +x runAIProject.sh\n```\n\nOptionally, add `runAIProject.sh` to your system’s `PATH`. For example, on Arch/Manjaro:\n\n```bash\nsudo ln -s $(pwd)/runAIProject.sh /usr/local/bin/runAIProject\n```\n\n## 🚀 Usage\n\n```bash\nrunAIProject [OUTPUT_FILENAME] [--tree] [--config=PATH_TO_CONFIG]\n```\n\nBy default, this command generates a text dump of the current directory’s source files and saves it to `ai.txt`.\n\n### Options\n\n* `OUTPUT_FILENAME` (optional): Custom name for the output file (default: `ai.txt`)\n* `--tree` (optional): Outputs a directory tree instead of dumping file contents\n* `--config=...` (optional): Use a specific `ai.json` configuration file\n\n## 🧠 `ai.json` Configuration\n\nYou can control which files and folders are included or excluded by providing an `ai.json` file in your project’s root directory. This will override the default rules.\n\n### Structure of `ai.json`\n\n```json\n{\n  \"exclude\": {\n    \"extensions\": [\"log\", \"png\", \"jpg\"],\n    \"folders\": [\"vendor\", \"node_modules\", \"tests\"],\n    \"filenames\": [\"README.md\", \".env\"]\n  },\n  \"include\": {\n    \"extensions\": [],\n    \"folders\": [],\n    \"filenames\": []\n  }\n}\n```\n\n### Priority\n\nIf `ai.json` is present and readable, its values will override the default ignore lists.\n\n## 📦 Examples\n\n```bash\nrunAIProject\n```\n\nGenerates a file dump and writes it to `ai.txt`.\n\n```bash\nrunAIProject ai2.txt\n```\n\nSame as above, but writes to `ai2.txt`.\n\n```bash\nrunAIProject --tree\n```\n\nOutputs a directory tree structure to `ai.txt`.\n\n```bash\nrunAIProject ai2.txt --tree\n```\n\nOutputs a directory tree structure to `ai2.txt`.\n\n```bash\nrunAIProject --config=./config/ai-custom.json\n```\n\nUses a custom configuration to control what is included or excluded.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjschwind%2Fphpcli-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjschwind%2Fphpcli-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjschwind%2Fphpcli-ai/lists"}