{"id":32127271,"url":"https://github.com/monkfromearth/monk-lang","last_synced_at":"2025-10-21T00:04:45.213Z","repository":{"id":304706356,"uuid":"859313422","full_name":"monkfromearth/monk-lang","owner":"monkfromearth","description":"A minimalist, readable, and performant language for the modern age","archived":false,"fork":false,"pushed_at":"2025-07-27T13:58:44.000Z","size":3296,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-24T13:55:40.707Z","etag":null,"topics":["language","programming"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/monkfromearth.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2024-09-18T13:03:40.000Z","updated_at":"2025-08-12T20:08:30.000Z","dependencies_parsed_at":"2025-07-14T22:34:13.340Z","dependency_job_id":"8465b32a-eecb-4112-94d5-004c20fed9a9","html_url":"https://github.com/monkfromearth/monk-lang","commit_stats":null,"previous_names":["monkfromearth/monk-lang"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/monkfromearth/monk-lang","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkfromearth%2Fmonk-lang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkfromearth%2Fmonk-lang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkfromearth%2Fmonk-lang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkfromearth%2Fmonk-lang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/monkfromearth","download_url":"https://codeload.github.com/monkfromearth/monk-lang/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monkfromearth%2Fmonk-lang/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280179478,"owners_count":26285959,"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-20T02:00:06.978Z","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":["language","programming"],"created_at":"2025-10-21T00:04:23.048Z","updated_at":"2025-10-21T00:04:45.204Z","avatar_url":"https://github.com/monkfromearth.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Monk Lang\n\n\u003cimg src=\"https://lh3.googleusercontent.com/d/1Exu7IiDLYq-DBJojIcj3LZRLLznjHOsa\" alt=\"Monk Logo\" width=\"100\" height=\"100\" align=\"right\" /\u003e\n\nA minimalist, readable, and performant programming language for the modern age\n\n### **Design Goals:**\n- **Performance**: Powered by Bun's ultra-fast JavaScript runtime and native single-executable bundling\n- **Readability**: Clean, Python-inspired syntax without unnecessary ceremony\n- **Memory Safety**: Simplified borrowing model inspired by Rust\n- **Static Type Safety**: First-assignment type inference, optional types, and structural validation\n- **Minimal Syntax**: No semicolons, no `func` keyword, clean and concise\n- **Error Handling**: Explicit error handling with `guard`/`against`/`throw` patterns\n\n## Quick Start\n\n### Installation\n\n#### Direct Installation\n\n**Linux/macOS:**\n\n```bash\ncurl -fsSL https://bit.ly/monk-lang | bash\n```\n\nor\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/monkfromearth/monk-lang/main/install.sh | bash\n```\n\n**Windows:** Download from [GitHub Releases](https://github.com/monkfromearth/monk-lang/releases/latest)\n\n\n#### Package Managers (Recommended)\n\n**Homebrew (macOS/Linux):**\n```bash\nbrew install monkfromearth/monk-lang/monk-lang\n```\n\n**APT (Ubuntu/Debian):**\n```bash\n# Add repository (one-time setup)\ncurl -fsSL https://monk-lang.github.io/apt/gpg.key | sudo apt-key add -\necho \"deb https://monk-lang.github.io/apt stable main\" | sudo tee /etc/apt/sources.list.d/monk-lang.list\n\n# Install\nsudo apt update\nsudo apt install monk-lang\n```\n\n**Chocolatey (Windows):**\n```bash\nchoco install monk-lang\n```\n\n**Snap (Linux):**\n```bash\nsudo snap install monk-lang\n```\n\n\n#### Build from Source\n\n```bash\ngit clone https://github.com/monkfromearth/monk-lang.git\ncd monk-lang\nbun install \u0026\u0026 bun run build\n```\n\n### VS Code / Cursor / Windsurf Extension\n\nGet the official VS Code extension from the [Marketplace](https://marketplace.visualstudio.com/items?itemName=monkfromearth.monk-lang) for syntax highlighting, autocomplete, and integrated development features:\n\n```bash\ncode --install-extension monkfromearth.monk-lang\n```\n\n### Hello World\n```monk\nconst message = \"Hello, World!\"\nshow(message)\n```\n\n```bash\nmonk run hello.monk\n```\n\n### Interactive REPL\n```bash\nmonk repl\n```\n\n## Language Features\n\n✅ **Core Language**\n- Variables and constants (`let`, `const`)\n- All basic data types (numbers, strings, booleans, references)\n- Arithmetic, comparison, and logical operators\n- Control flow (if/else, while, for loops)\n- Functions with closures and recursion\n- References and memory safety\n- Comprehensive error handling\n\n✅ **Static Type System**\n- First-assignment type inference with enforcement\n- Optional types with `?` syntax (`int?`, `string?`, arrays)\n- Definite assignment analysis preventing uninitialized reads\n- Array and record element type enforcement\n- Function return type validation across all paths\n- Closed record literals with structural validation\n- Property access validation with static errors\n- Multi-line record literals with proper syntax support\n\n✅ **Development Tools**\n- Command-line interface with linting and formatting\n- Interactive REPL\n- VS Code extension with syntax highlighting\n- Comprehensive linting and formatting system\n- Complete test suite (491 tests passing)\n\n## Documentation\n\n📚 **[Complete Documentation](docs/website/docs/intro.md)** - Comprehensive guides and tutorials\n\nQuick Links:\n- **[Getting Started](docs/website/docs/getting-started/)** - Installation and first steps\n- **[Language Reference](docs/website/docs/language-reference/)** - Complete language documentation\n- **[Development Tools](docs/website/docs/development-tools/)** - LSP, linting, formatting, and more\n- **[Built-in Functions](docs/website/docs/builtin-functions/)** - Complete function reference\n- **[Examples](examples/index.md)** - 20 comprehensive example programs\n\n## Development\n\n```bash\nbun run test     # Run comprehensive test suite (491 tests)\nbun run dev      # Development mode with file watching\nbun run lint     # Code linting with Monk's built-in linter\nbun run format   # Code formatting with Monk's formatter\nmonk lint src/   # Lint Monk source files\nmonk format src/ # Format Monk source files\n```\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Quick Steps:**\n1. Fork the repository\n2. Create a feature branch\n3. Add tests for new features\n4. Ensure all tests pass (`bun run test`)\n5. Submit a pull request\n\n## More Information\n\n- **[Language Specification](ABOUT.md)** - Complete language design and syntax\n- **[Build Guide](docs/development/build-guide.md)** - Detailed build instructions\n- **[Development Tasks](docs/development/tasks.md)** - Implementation roadmap\n- **[Changelog](CHANGELOG.md)** - Release history\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\nHappy coding with Monk! 🕯️\n\n\u003ca href=\"https://www.flaticon.com/free-icons/candle\" title=\"candle icons\"\u003eCandle icons created by Freepik - Flaticon\u003c/a\u003e\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonkfromearth%2Fmonk-lang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonkfromearth%2Fmonk-lang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonkfromearth%2Fmonk-lang/lists"}