{"id":24871205,"url":"https://github.com/dragonxdev/amcsh","last_synced_at":"2025-06-29T22:33:27.623Z","repository":{"id":274255759,"uuid":"922369731","full_name":"DragonXDev/amcsh","owner":"DragonXDev","description":"A high-performance Unix shell designed for speed","archived":false,"fork":false,"pushed_at":"2025-01-26T02:56:30.000Z","size":62,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T22:46:21.470Z","etag":null,"topics":["cli","high-performance","unix"],"latest_commit_sha":null,"homepage":"","language":"C","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/DragonXDev.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":"2025-01-26T02:25:37.000Z","updated_at":"2025-01-26T03:04:35.000Z","dependencies_parsed_at":"2025-01-26T03:37:19.568Z","dependency_job_id":null,"html_url":"https://github.com/DragonXDev/amcsh","commit_stats":null,"previous_names":["dragonxdev/amcsh"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DragonXDev/amcsh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonXDev%2Famcsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonXDev%2Famcsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonXDev%2Famcsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonXDev%2Famcsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DragonXDev","download_url":"https://codeload.github.com/DragonXDev/amcsh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DragonXDev%2Famcsh/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262678268,"owners_count":23347335,"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","high-performance","unix"],"created_at":"2025-02-01T04:31:17.627Z","updated_at":"2025-06-29T22:33:27.579Z","avatar_url":"https://github.com/DragonXDev.png","language":"C","readme":"# 🚀 amcsh - Advanced Modern C Shell\n\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]()\n[![C Version](https://img.shields.io/badge/C-C11-orange.svg)]()\n[![Platform](https://img.shields.io/badge/platform-macOS%20|%20Linux-lightgrey.svg)]()\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/images/amcsh-dark.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"assets/images/amcsh-light.png\"\u003e\n  \u003cimg alt=\"amcsh Logo\" src=\"assets/images/amcsh-light.png\" width=\"400\"\u003e\n\u003c/picture\u003e\n\n*A high-performance, modern shell written in C with focus on speed and efficiency* 🏃‍♂️💨\n\n\u003c/div\u003e\n\n## ✨ Features\n\n- 🚄 **High Performance**: Uses `posix_spawn` instead of traditional `fork/exec`\n- 🧵 **Parallel Execution**: Built-in thread pool for concurrent operations\n- 🔄 **Smart Caching**: Optimized command caching with LRU eviction\n- 🎯 **Job Control**: Full job control with background process support\n- 🔍 **Tab Completion**: Intelligent command completion using trie data structure\n- 📜 **History Management**: Efficient command history with search capabilities\n- 🔧 **Built-in Commands**: Optimized built-in commands for common operations\n\n## 🎯 Performance\n\nAMCSH is designed with performance in mind:\n\n- ⚡️ **Fast Process Creation**: Up to 30% faster than traditional shells\n- 📊 **Memory Efficient**: Optimized memory usage with smart data structures\n- 🔄 **Quick Command Lookup**: O(1) command resolution with hash-based cache\n- 🧵 **Parallel Operations**: Asynchronous execution of shell operations\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n```bash\n# Install CMake (macOS)\nbrew install cmake\n\n# Install CMake (Ubuntu/Debian)\nsudo apt-get install cmake\n```\n\n### Building from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/amcsh.git\ncd amcsh\n\n# Create build directory\nmkdir build \u0026\u0026 cd build\n\n# Build\ncmake ..\nmake\n\n# Run AMCSH\n./amcsh\n```\n\n## 💡 Usage\n\n### Basic Commands\n\n```bash\n# Change directory\ncd /path/to/directory\n\n# List jobs\njobs\n\n# Background processes\ncommand \u0026\n\n# Bring job to foreground\nfg %1\n\n# Send job to background\nbg %1\n```\n\n### Advanced Features\n\n```bash\n# Command history search\nctrl-r\n\n# Tab completion\ncommand\u003ctab\u003e\n\n# Process substitution\ncommand $(another_command)\n\n# I/O redirection\ncommand \u003e output.txt 2\u003e error.log\n```\n\n## 🏗 Architecture\n\nAMCSH is built with a modular architecture:\n\n```\namcsh/\n├── src/\n│   ├── main.c          # Main shell loop\n│   ├── executor.c      # Command execution\n│   ├── parser.c        # Command parsing\n│   ├── builtins.c      # Built-in commands\n│   ├── completion.c    # Tab completion\n│   ├── history.c       # History management\n│   ├── job_control.c   # Job control\n│   ├── thread_pool.c   # Thread pool\n│   └── cmd_cache.c     # Command cache\n├── include/\n│   ├── amcsh.h         # Main header\n│   └── parser.h        # Parser definitions\n├── assets/\n│   └── images/         # Logo and images\n└── build/              # Build artifacts\n```\n\n## 🔧 Configuration\n\nAMCSH can be configured through environment variables:\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `AMCSH_HISTORY_SIZE` | Maximum history entries | 1000 |\n| `AMCSH_CACHE_SIZE` | Command cache size | 128 |\n| `AMCSH_MAX_THREADS` | Thread pool size | 4 |\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'feat: Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a PR\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 👥 Authors\n\n- Amaar - *Initial work* - [GitHub Profile](https://github.com/dragonxdev)\n\n## 🙏 Acknowledgments\n\n- Inspired by modern shell designs\n- Built with performance optimization techniques\n- Thanks to all contributors\n\n---\n\u003cdiv align=\"center\"\u003e\nMade by Amaar :)\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragonxdev%2Famcsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdragonxdev%2Famcsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdragonxdev%2Famcsh/lists"}