{"id":15060899,"url":"https://github.com/piotrjustyna/argon","last_synced_at":"2026-01-19T21:33:18.082Z","repository":{"id":207746855,"uuid":"719669310","full_name":"PiotrJustyna/argon","owner":"PiotrJustyna","description":"minimal dotnet development environment","archived":false,"fork":false,"pushed_at":"2023-12-11T16:40:31.000Z","size":1896,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2023-12-11T17:32:05.091Z","etag":null,"topics":["csharp","development-environment","docker","dotnet","fsharp","minimal"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/piotrjustyna/argon","language":"Shell","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/PiotrJustyna.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}},"created_at":"2023-11-16T16:50:10.000Z","updated_at":"2023-12-20T15:52:20.845Z","dependencies_parsed_at":"2023-12-11T17:31:32.847Z","dependency_job_id":null,"html_url":"https://github.com/PiotrJustyna/argon","commit_stats":null,"previous_names":["piotrjustyna/argon"],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrJustyna%2Fargon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrJustyna%2Fargon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrJustyna%2Fargon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrJustyna%2Fargon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PiotrJustyna","download_url":"https://codeload.github.com/PiotrJustyna/argon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289430,"owners_count":20914464,"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":["csharp","development-environment","docker","dotnet","fsharp","minimal"],"created_at":"2024-09-24T23:06:15.393Z","updated_at":"2026-01-19T21:33:18.054Z","avatar_url":"https://github.com/PiotrJustyna.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"- [argon](#argon)\n  - [features](#features)\n    - [argon-micro](#argon-micro)\n    - [argon-micro-dotnet](#argon-micro-dotnet)\n    - [argon-micro-terraform](#argon-micro-terraform)\n    - [argon](#argon-1)\n    - [argon-dotnet](#argon-dotnet)\n  - [manifesto](#manifesto)\n  - [host requirements](#host-requirements)\n  - [how to](#how-to)\n    - [start](#start)\n    - [stop](#stop)\n    - [customisation](#customisation)\n      - [`ARG`](#arg)\n      - [volumes](#volumes)\n  - [resources](#resources)\n\n# argon\n\nMinimal development environment.\n\nBuild and run your code in a container exposing an interactive zsh shell. It looks like your regular shell, but everything is installed and running in a docker container. When you're done, simply `exit` argon shell to get back to your regular shell.\n\n## features\n\nArgon supports two types of cpu architectures:\n\n* arm64\n\n* amd64\n\n![](./img/argon-features.svg)\n\n### argon-micro\n\nOnly core features of base argon:\n\n* `alpine 3.20.2` base\n\n* `zsh` + `oh my zsh`\n\n* `git`\n\n* `openssh`\n\n* `curl`\n\n### argon-micro-dotnet\n\nDotnet development support.\n\n* argon-micro\n\n* `.net 8.0 sdk` as an `apk` package\n\n### argon-micro-terraform\n\nTerraform + aws development support. This environment comes with a lower base version of alpine as the terraform package is no longer included in alpine 2.19+. Host aws credentials are shared with the development environment container.\n\n* argon-micro\n\n* terraform\n\n* aws cli\n\n### argon\n\nA more fleshed out base version of argon - just basic documentation-writing tools.\n\n* argon-micro\n\n* `markdown`\n\n  * `pandoc`\n\n  * `mermaid`\n\n  * `pdflatex` (via `texlive`)\n\n  * `marp`\n\n### argon-dotnet\n\nDotnet development support.\n\n* argon\n\n* `.net 8.0 sdk` as an `apk` package\n\n![](./img/2024-01-09-demo.png)\n\n## manifesto\n\n* \\**lean* and \\*\\**quiet* development environment\n\n* take your development environment anywhere\n\n* low expectations from your text editor - keep it:\n\n  * vanilla\n\n  * removed from the equation\n\n* reuse host's ssh keys\n\n---\n\n* \\**lean* - minimal number of unused components\n\n* \\*\\**quiet* - minimal number of errors\n\n## host requirements\n\n* docker\n\n## how to\n\n### start\n\n* `./[argon type here*]/host.sh` - starts the development environment\n\n\\**where argon type is argon micro, argon, argon-dotnet, etc...*\n\n### stop\n\n`exit`\n\n### customisation\n\n#### `ARG`\n\n* **`$USER_NAME`** - controls the name of the default account controlling the development environment. Possible values:\n\n  * **root** - default value, **root** will be the default user acount\n\n  * **[any other value]** - will result in creating **argon-development-group** group and a non-root default member account named **[any other value]**\n\n#### volumes\n\n* **`$CERTIFICATE_DIRECTORY`** - host's `.ssh` directory. This is useful for upstream git operations.\n\n## resources\n\n* [text to ascii art generator](https://patorjk.com/software/taag/#p=display\u0026f=Graffiti\u0026t=Type%20Something%20)\n\n* [github wiki toc generator](https://ecotrust-canada.github.io/markdown-toc/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrjustyna%2Fargon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiotrjustyna%2Fargon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrjustyna%2Fargon/lists"}