{"id":31769593,"url":"https://github.com/stillerman/projectscout","last_synced_at":"2025-10-10T02:51:43.943Z","repository":{"id":245502054,"uuid":"818440890","full_name":"Stillerman/ProjectScout","owner":"Stillerman","description":"ProjectScout is a library designed to prepare a codebase for ingestion with an LLM. It provides tools to analyze directory contents, offering insights into file structures, token counts, and more.","archived":false,"fork":false,"pushed_at":"2024-07-06T16:38:16.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-06T17:47:56.503Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/Stillerman.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}},"created_at":"2024-06-21T21:35:20.000Z","updated_at":"2024-07-06T16:38:19.000Z","dependencies_parsed_at":"2024-06-22T13:03:21.114Z","dependency_job_id":"fcfe8dd7-bf2b-44bf-8ee8-c7cfd7c1e46b","html_url":"https://github.com/Stillerman/ProjectScout","commit_stats":null,"previous_names":["stillerman/projectscout"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Stillerman/ProjectScout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stillerman%2FProjectScout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stillerman%2FProjectScout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stillerman%2FProjectScout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stillerman%2FProjectScout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Stillerman","download_url":"https://codeload.github.com/Stillerman/ProjectScout/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stillerman%2FProjectScout/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002551,"owners_count":26083403,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-10-10T02:51:35.946Z","updated_at":"2025-10-10T02:51:43.933Z","avatar_url":"https://github.com/Stillerman.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ProjectScout\n\nProjectScout is a library designed to prepare a codebase for ingestion with an LLM. It provides tools to analyze directory contents, offering insights into file structures, token counts, and more.\n\n## Features\n\n- **Overview:** Print the directory structure with optional token counts and file contents.\n- **Search:** Search for a specific pattern within the entire project.\n- **Modify:** Modify the contents of a specified file.\n\n## Installation\n\n1. **Clone the repository:**\n    ```sh\n    git clone https://github.com/stillerman/ProjectScout\n    cd ProjectScout\n    ```\n\n2. **Create a virtual environment and activate it:**\n    ```sh\n    python3 -m venv .venv\n    source .venv/bin/activate\n    ```\n\n3. **Install dependencies:**\n    ```sh\n    pip install -r requirements.txt\n    ```\n\n## Usage\n\n### Basic Commands\n\n1. **Overview:**\n    ```sh\n    python cli.py overview [DIRECTORY] [OPTIONS]\n    ```\n    Options:\n    - `--tokens` : Include token counts for each file.\n    - `--content` : Include contents of each file.\n    - `--large, -l [N]` : Show the top N largest files with the most tokens.\n    \n    Example:\n    ```sh\n    python cli.py overview ./my_project --tokens --content --large 5\n    ```\n\n2. **Search:**\n    ```sh\n    python cli.py search [DIRECTORY] [PATTERN]\n    ```\n\n    Example:\n    ```sh\n    python cli.py search ./my_project \"TODO\"\n    ```\n\n3. **Modify:**\n    ```sh\n    python cli.py modify [FILE_PATH] [CONTENT]\n    ```\n\n    Example:\n    ```sh\n    python cli.py modify ./my_project/file.txt \"New content for the file.\"\n    ```\n\n## Detailed Description\n\n### Token Counting\nProjectScout uses the GPT-4 tokenizer to count tokens in text files. This feature helps in identifying the token distribution across files, which is particularly useful for projects involving natural language processing and machine learning.\n\n### Directory Structure Printing\nThis library can print the directory structure of a given directory. It can also include token counts for each file and display the contents of the files. This makes it easier to get an overview of the project's structure and content.\n\n### Project Search\nYou can search for specific patterns within the project, making it easy to locate references to certain functions, variables, or comments across the codebase.\n\n### File Modification\nProjectScout also includes a command to modify the contents of a specified file, allowing for quick updates and changes directly from the command line.\n\n## Contributing\nWe welcome contributions! Please fork the repository and submit a pull request with your changes. Ensure that your code adheres to the existing style and includes appropriate tests.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact\nFor any questions or feedback, please open an issue on the GitHub repository.\n\n---\n\n**Enjoy using ProjectScout!** 🚀","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstillerman%2Fprojectscout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstillerman%2Fprojectscout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstillerman%2Fprojectscout/lists"}