{"id":17093105,"url":"https://github.com/souvikinator/node-eyeson","last_synced_at":"2026-04-09T11:43:03.249Z","repository":{"id":57106008,"uuid":"321079833","full_name":"souvikinator/node-eyeson","owner":"souvikinator","description":"minimal file watcher cli written in node.","archived":false,"fork":false,"pushed_at":"2021-03-27T06:05:02.000Z","size":40003,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-03T11:04:29.555Z","etag":null,"topics":["cli-tool","eyeson","file-watcher","linux","macos","nodejs","windows"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@darthcucumber/eyes-on","language":"JavaScript","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/souvikinator.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}},"created_at":"2020-12-13T14:08:51.000Z","updated_at":"2022-08-25T03:56:52.000Z","dependencies_parsed_at":"2022-08-20T22:10:15.993Z","dependency_job_id":null,"html_url":"https://github.com/souvikinator/node-eyeson","commit_stats":null,"previous_names":["darthcucumber/node-eyeson"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/souvikinator%2Fnode-eyeson","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/souvikinator%2Fnode-eyeson/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/souvikinator%2Fnode-eyeson/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/souvikinator%2Fnode-eyeson/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/souvikinator","download_url":"https://codeload.github.com/souvikinator/node-eyeson/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244117258,"owners_count":20400741,"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","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":["cli-tool","eyeson","file-watcher","linux","macos","nodejs","windows"],"created_at":"2024-10-14T14:04:39.812Z","updated_at":"2025-12-30T23:29:59.850Z","avatar_url":"https://github.com/souvikinator.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cpre\u003e\r\n ▄▄▄▄▄▄▄ ▄▄   ▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄ ▄▄    ▄ \r\n█       █  █ █  █       █       █  █       █  █  █ █\r\n█    ▄▄▄█  █▄█  █    ▄▄▄█  ▄▄▄▄▄█  █   ▄   █   █▄█ █\r\n█   █▄▄▄█       █   █▄▄▄█ █▄▄▄▄▄   █  █ █  █       █\r\n█    ▄▄▄█▄     ▄█    ▄▄▄█▄▄▄▄▄  █  █  █▄█  █  ▄    █\r\n█   █▄▄▄  █   █ █   █▄▄▄ ▄▄▄▄▄█ █  █       █ █ █   █\r\n█▄▄▄▄▄▄▄█ █▄▄▄█ █▄▄▄▄▄▄▄█▄▄▄▄▄▄▄█  █▄▄▄▄▄▄▄█▄█  █▄▄█\r\n\u003c/pre\u003e\r\n\r\n**Eyes-on** is a minimal Cross-platform command line file watcher which lets user watch for modification/deletion over single/multiple files.\r\n\r\n\r\n# 📃Features/Todos\r\n\r\n- [x]  Watches for *modification* and *deletion* in files\r\n- [x]  Users can change the checking interval of `eyeson` based on their needs\r\n- [x]  Users can pass command to execute which triggers when any file in watch list is *modified*.\r\n\r\n# 🔧Installation\r\n\r\nDownload suitable Eyeson execuatble from [here](https://github.com/DarthCucumber/node-eyeson/releases/tag/v1.0.0)\r\n\r\nafter downloading the suitable binary file, set the path variable for the binary like so:\r\n\r\n**For macOs and Linux**\r\n```bash\r\nPATH=\"/path/to the downloaded/binary/file:$PATH\"\r\n```\r\n\r\nor \r\n\r\nif your have node js installed then use:\r\n\r\n```bash\r\nnpm install -g @darthcucumber/eyes-on\r\n```\r\n\r\n# 💻Usage\r\n\r\n### Commands and Flags\r\n\r\n![enter image description here](https://i.ibb.co/7GNy9vq/Screenshot-2020-12-14-021328.jpg)\r\n\r\n### Examples\r\n\r\n- **Watching over single file**\r\n\r\n```bash\r\neyeson watch file1.txt\r\n```\r\nwatches over `file1.txt`\r\n\r\n- **Watching over multiple files**\r\n\r\n```bash\r\neyeson watch file1.txt file2.txt file3.txt\r\n```\r\nwatches over the file name provided as agrs.\r\n**note:** if any of the file provided as agrs does not exists then it stops watching and exits.\r\n\r\n- **Watching over all the files in current directory**\r\n\r\n```bash\r\neyeson watch *\r\n```\r\ngives following result:\r\n![enter image description here](https://i.ibb.co/DfBnJsp/h-Hr-Cx-Vav-Jc.gif)\r\n\r\n- **Watching over specific files in current directory**\r\n\r\n```bash\r\neyeson watch *.js\r\n```\r\nonly  watches  for all `js` files in the directory\r\ngives following result:\r\n![enter image description here](https://i.ibb.co/dmrcCKM/xg-G2qy-Tb-Av.gif)\r\n\r\n- **Changing watch interval time**\r\n\r\n```bash\r\neyeson watch *.js -t=1000\r\n```\r\nthis changes the interval to 1000ms (1s) i.e the interval at which **eyeson** checks for file modification. Takes input in milliseconds. Default is 2s or 2000ms.\r\n\r\n- **Passing single line commands**\r\n\r\n```bash\r\neyeson watch test.py -c=\"python3 test.py\"\r\n```\r\nthis executes `python3 test.py` (runs the python file test.py) command on any modification in the files its watching over.\r\ngives following result:\r\n\r\n![enter image description here](https://i.ibb.co/Qmx4Vnc/y7-Owwy-Jb3m.gif)\r\n\r\n- **Passing multiple line commands**\r\n\r\n```bash\r\neyeson watch test.cpp -c=\"g++ -o test test.cpp\r\n./test\"\r\n```\r\nthis executes `g++ -o test test.cpp` (compiles test.cpp)  first and then executes `./test` (runs the cpp program) on any modification in the files its watching over. This feature comes in very handy.\r\n\r\ngives following result:\r\n\r\n![enter image description here](https://i.ibb.co/3mYtSDQ/Ra160-PGf-Bv.gif)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsouvikinator%2Fnode-eyeson","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsouvikinator%2Fnode-eyeson","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsouvikinator%2Fnode-eyeson/lists"}