{"id":22797703,"url":"https://github.com/agent-hellboy/fmsh","last_synced_at":"2026-02-18T04:34:09.502Z","repository":{"id":263273596,"uuid":"889624509","full_name":"Agent-Hellboy/fmsh","owner":"Agent-Hellboy","description":"fmsh is a lightweight and high-performance file management shell","archived":false,"fork":false,"pushed_at":"2025-03-12T07:15:54.000Z","size":9088,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-30T17:51:42.787Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Agent-Hellboy.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}},"created_at":"2024-11-16T19:54:55.000Z","updated_at":"2025-03-12T07:15:58.000Z","dependencies_parsed_at":"2024-11-17T14:17:44.678Z","dependency_job_id":"db1baf57-29e2-447f-bcb9-84723fee387f","html_url":"https://github.com/Agent-Hellboy/fmsh","commit_stats":null,"previous_names":["agent-hellboy/fmsh"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/Agent-Hellboy/fmsh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agent-Hellboy%2Ffmsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agent-Hellboy%2Ffmsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agent-Hellboy%2Ffmsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agent-Hellboy%2Ffmsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Agent-Hellboy","download_url":"https://codeload.github.com/Agent-Hellboy/fmsh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agent-Hellboy%2Ffmsh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29568629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T04:18:28.490Z","status":"ssl_error","status_checked_at":"2026-02-18T04:13:49.018Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2024-12-12T06:06:46.485Z","updated_at":"2026-02-18T04:34:04.494Z","avatar_url":"https://github.com/Agent-Hellboy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# **fmsh - File Management Shell**\n\n![fmsh](./fmsh.png)\n\n`fmsh` is a lightweight and high-performance file management shell designed to streamline file system operations and analytics. The shell provides a user-friendly interface to manage files, perform advanced analytics, and execute tasks efficiently, leveraging the power of Go’s **goroutines** for enhanced performance.\n\n---\n\n## **Key Features**\n\n### **Performance Optimization with Goroutines**\n\n- Use gorotine to optmise the linux commands like `cp`, `find` and others.\n- e.g the analytics command (`inspect`) leverages **goroutines** to analyze files and directories in parallel, significantly reducing processing time for large directories. Looking forwards to leverage it in other commands\n- Undo functionality for rm like commands\n\n---\n\n## **Getting Started**\n\n### **Installation**\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/Agent-Hellboy/fmsh.git\n   cd fmsh\n   ```\n\n2. Build the project:\n   ```bash\n   go build -o fmsh ./cmd\n   ```\n\n3. Run the shell:\n   ```bash\n   ./fmsh\n   ```\n\n---\n\n#### \n - Currently, you can install the binary for Mac using homebrew \n \n\n## **Usage**\n\n### **1. Start the Shell**\nLaunch the shell:\n```bash\nfmsh\u003e\n```\n\n### **2. Run Commands**\nExample commands:\n- **Analytics**:\n  ```bash\n  fmsh\u003e inspect\n  ```\n  Output:\n  ```\n  File System Analytics for: /example-dir\n  -----------------------------------------\n  Number of files: 10\n  Number of directories: 3\n  Total size of files: 20480 bytes\n  Largest file: /example-dir/file4.png (4096 bytes)\n  Most recently modified file: /example-dir/file2.go (Modified at: Thu, 20 Nov 2024 14:23:45 UTC)\n  -----------------------------------------\n  ```\n\n---\n\n## **Commands**\n\n| Command            | Description                                      |\n|--------------------|--------------------------------------------------|\n| `inspect`          | Perform analytics on the current directory.      |\n| `search`           | Search files with wildcard patterns.             |\n| `disk-usage`       | Summarize the disk usage of the current directory.|\n| `tree`             | Display the directory structure in a tree format.|\n| `clean-tmp`        | Identify and optionally delete temporary files.  |\n| `zip`              | Create a zip archive of specified files.         |\n| `unzip`            | Extract a zip archive.                           |\n| `rename`           | Rename a file or directory.                      |\n| `chmod`            | Modify file permissions.                         |\n| `open`             | Open a file with the system's default application.|\n| `preview`          | Display the first few lines of a file.           |\n\nSeveral others\n\n---\n\n## **Why fmsh?**\n\n- **Performance**: Uses Go’s **goroutines** for high-performance analytics.\n- **Flexibility**: Offers a variety of commands for common file management tasks.\n- **Simplicity**: Intuitive command structure for easy interaction.\n\n---\n\n## **Contributing**\n\nWe welcome contributions to improve `fmsh`! Feel free to submit pull requests or open issues on GitHub.\n\n---\n\n## **License**\n\nThis project is licensed under the **GPL-3.0 License**.\n\n---\n\n## **Future Enhancements**\n\nA lot can be done.  \n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-hellboy%2Ffmsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagent-hellboy%2Ffmsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagent-hellboy%2Ffmsh/lists"}