Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/artagon/artagon-vscode-profiles

Portable, profile‑based VS Code setup (Web/Astro, Java via jenv, Rust, C/C++), crisp/retina baselines; Copilot‑only AI
https://github.com/artagon/artagon-vscode-profiles

astro copilot cpp developer-experience java jenv profiles rust typescript vscode web

Last synced: about 2 months ago
JSON representation

Portable, profile‑based VS Code setup (Web/Astro, Java via jenv, Rust, C/C++), crisp/retina baselines; Copilot‑only AI

Awesome Lists containing this project

README 

          
# VS Code Profiles (XDG Managed)



This repository tracks all Visual Studio Code profiles, shared settings, and helper scripts under `~/.config/vscode`. It replaces the stock `User/` folder with a reproducible, profile-aware layout and scripting toolkit. Clone it anywhere (e.g., `~/src/vscode-profiles`) if you prefer—profile symlinks stay relative, so the layout remains portable even when teammates do not follow the same XDG conventions.



## About



[![OS macOS](https://img.shields.io/badge/os-macOS-000000?logo=apple&logoColor=white)](#)

[![OS Linux](https://img.shields.io/badge/os-Linux-0b7261?logo=linux&logoColor=white)](#)

[![OS Windows](https://img.shields.io/badge/os-Windows-0078D4?logo=windows&logoColor=white)](#)

[![AI Copilot Only](https://img.shields.io/badge/AI-Copilot%20only-1f6feb?logo=githubcopilot&logoColor=white)](#)

[![Topics](https://img.shields.io/badge/profiles-astro%2C%20java%2C%20rust%2C%20c%2B%2B-4a7bbb)](#)



- Portable, profile‑based VS Code setup with crisp/retina shared baselines and per‑profile overrides.

- Web/Astro (TypeScript/JS + HTML/CSS), Java via jenv, Rust, and C/C++ stacks pre‑configured.

- AI policy: GitHub Copilot + Copilot Chat only (no other assistants).

- Scripts for validate/compose/export/open/install; exports ready for “Profiles: Import Profile”.



## Quick Start (First‑Time Users)

- Requirements: VS Code CLI on PATH (`code --version`) and `jq`.

- Compose + export:

  - `bash scripts/compose-settings.sh && bash scripts/export-profiles.sh`

- Open a profile without installing extensions (registers it):

  - `scripts/open-profiles.sh --skip-install web-astro-crisp`

- Install extensions for a profile:

  - `bash scripts/install-extensions.sh web-astro-crisp`

- Tip: `vspcli --open-profiles --skip-install ` to open multiple at once.



### Profiles Overview

- Web (Astro/Node): `web-astro-(crisp|retina)` with Astro syntax, Prettier/ESLint, Tailwind, HTML/CSS/npm/path IntelliSense, Emmet in `.astro`.

- Java: `java-*-*` (jenv-driven via `${command:jenv.javaHome}`), Spring/Maven/Gradle focused variants.

- Rust: `rust-profile-(crisp|retina)` (rust-analyzer, CodeLLDB, Dependi, TOML).

- C/C++: `cpp-clangd-(crisp|retina)` and `cpp-intellisense-(crisp|retina)`.

- AI bundle: `ai-profile-(crisp|retina)` with GitHub Copilot + Copilot Chat only.



## Profile Matrix



| Profile | Stack | Extensions | Export (CR/RT) | Notes |

|---|---|---|---|---|

| `web-astro-(crisp|retina)` | Astro · Node · TS/JS · HTML/CSS | [full list](#ext-web-astro) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/web-astro-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/web-astro-retina.code-profile) | Prettier on save; Astro formatter; Emmet in `.astro`; Tailwind mapped for Astro; TOML formatting |

| `java-profile-(crisp|retina)` | Java (general) | [full list](#ext-java-profile) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/java-profile-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/java-profile-retina.code-profile) | JDK via `${command:jenv.javaHome}`; Gradle & Maven enabled |

| `java-gradle-(crisp|retina)` | Java (Gradle‑first) | [full list](#ext-java-gradle) | — | Maven import disabled; jenv for JDK |

| `java-maven-(crisp|retina)` | Java (Maven‑first) | [full list](#ext-java-maven) | — | Gradle import disabled; jenv for JDK |

| `java-spring-(crisp|retina)` | Spring Boot | [full list](#ext-java-spring) | — | jenv for Spring LS; Spring YAML schema |

| `rust-profile-(crisp|retina)` | Rust | [full list](#ext-rust) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/rust-profile-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/rust-profile-retina.code-profile) | clippy on save; exclude `**/target`; TOML formatting |

| `cpp-clangd-(crisp|retina)` | C/C++ (clangd) | [full list](#ext-cpp-clangd) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-clangd-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-clangd-retina.code-profile) | clang‑tidy; Ninja; build dirs excluded |

| `cpp-intellisense-(crisp|retina)` | C/C++ (cpptools) | [full list](#ext-cpp-cpptools) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-intellisense-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-intellisense-retina.code-profile) | cpptools provider; `compile_commands.json`; Ninja |

| `ai-profile-(crisp|retina)` | Utilities / AI | [full list](#ext-ai) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-profile-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-profile-retina.code-profile) | Copilot‑only policy; chat center |

| `ai-plus-(crisp|retina)` | Utilities / AI (Copilot + Cody + Continue) | [full list](#ext-ai-plus) | [CR](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-plus-crisp.code-profile) · [RT](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-plus-retina.code-profile) | Experimental “try more AI” bundle |



### Downloadable Profile Bundles



Click an Export badge to download the `.code-profile` bundle for easy import in VS Code (Profiles → Import Profile).



| Profile | Export |

|---|---|

| web-astro-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/web-astro-crisp.code-profile) |

| web-astro-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/web-astro-retina.code-profile) |

| java-profile-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/java-profile-crisp.code-profile) |

| java-profile-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/java-profile-retina.code-profile) |

| rust-profile-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/rust-profile-crisp.code-profile) |

| rust-profile-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/rust-profile-retina.code-profile) |

| cpp-clangd-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-clangd-crisp.code-profile) |

| cpp-clangd-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-clangd-retina.code-profile) |

| cpp-intellisense-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-intellisense-crisp.code-profile) |

| cpp-intellisense-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/cpp-intellisense-retina.code-profile) |

| ai-profile-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-profile-crisp.code-profile) |

| ai-profile-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-profile-retina.code-profile) |

| ai-plus-crisp | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-plus-crisp.code-profile) |

| ai-plus-retina | [![Export](https://img.shields.io/badge/Export-.code--profile-0ea5e9)](https://raw.githubusercontent.com/artagon/artagon-vscode-profiles/main/exports/ai-plus-retina.code-profile) |



### Full Extension Lists



The following lists show the full set of extensions per profile family. Crisp and Retina variants share the same extension set unless otherwise noted.






  Web (Astro) — web-astro-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `enkia.tokyo-night`

- `foxundermoon.shell-format`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `oderwat.indent-rainbow`

- `pkief.material-icon-theme`

- `redhat.vscode-yaml`

- `sdras.night-owl`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `usernamehw.errorlens`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `astro-build.astro-vscode`

- `ecmel.vscode-html-css`

- `stylelint.vscode-stylelint`

- `clinyong.vscode-css-modules`

- `naumovs.color-highlight`

- `pranaygp.vscode-css-peek`

- `dbaeumer.vscode-eslint`

- `esbenp.prettier-vscode`

- `bradlc.vscode-tailwindcss`

- `christian-kohler.npm-intellisense`

- `eg2.vscode-npm-script`

- `christian-kohler.path-intellisense`

- `tamasfe.even-better-toml`

- `github.copilot`

- `github.copilot-chat`



Install all (CLI):



```bash

# web-astro-crisp

jq -r '.[].identifier.id' profiles/web-astro-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "web-astro-crisp" --install-extension "{}"



# web-astro-retina

jq -r '.[].identifier.id' profiles/web-astro-retina/extensions.json \

  | xargs -n1 -I{} code --profile "web-astro-retina" --install-extension "{}"

```



 






  Java (General) — java-profile-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `editorconfig.editorconfig`

- `enkia.tokyo-night`

- `esbenp.prettier-vscode`

- `foxundermoon.shell-format`

- `gabrielbb.vscode-lombok`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `oderwat.indent-rainbow`

- `pkief.material-icon-theme`

- `pmd.pmd`

- `redhat.java`

- `redhat.vscode-xml`

- `redhat.vscode-yaml`

- `richardwillis.vscode-gradle`

- `sdras.night-owl`

- `shengchen.vscode-checkstyle`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `timonwong.shellcheck`

- `usernamehw.errorlens`

- `vscjava.vscode-gradle`

- `vscjava.vscode-java-debug`

- `vscjava.vscode-java-dependency`

- `vscjava.vscode-java-pack`

- `vscjava.vscode-java-test`

- `vscjava.vscode-maven`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `fill-labs.dependi`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# java-profile-crisp

jq -r '.[].identifier.id' profiles/java-profile-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "java-profile-crisp" --install-extension "{}"



# java-profile-retina

jq -r '.[].identifier.id' profiles/java-profile-retina/extensions.json \

  | xargs -n1 -I{} code --profile "java-profile-retina" --install-extension "{}"

```



 






  Rust — rust-profile-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `enkia.tokyo-night`

- `fill-labs.dependi`

- `foxundermoon.shell-format`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `oderwat.indent-rainbow`

- `panicbit.cargo`

- `pkief.material-icon-theme`

- `redhat.vscode-yaml`

- `rust-lang.rust-analyzer`

- `sdras.night-owl`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `tamasfe.even-better-toml`

- `timonwong.shellcheck`

- `usernamehw.errorlens`

- `vadimcn.vscode-lldb`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `github.copilot`

- `github.copilot-chat`



Install all (CLI):



```bash

# rust-profile-crisp

jq -r '.[].identifier.id' profiles/rust-profile-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "rust-profile-crisp" --install-extension "{}"



# rust-profile-retina

jq -r '.[].identifier.id' profiles/rust-profile-retina/extensions.json \

  | xargs -n1 -I{} code --profile "rust-profile-retina" --install-extension "{}"

```



 






  C/C++ (clangd) — cpp-clangd-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `enkia.tokyo-night`

- `foxundermoon.shell-format`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `jeff-hykin.better-cpp-syntax`

- `llvm-vs-code-extensions.vscode-clangd`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vscode.cmake-tools`

- `ms-vscode.cpptools`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `notskm.clang-tidy`

- `oderwat.indent-rainbow`

- `pkief.material-icon-theme`

- `redhat.vscode-yaml`

- `sdras.night-owl`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `timonwong.shellcheck`

- `twxs.cmake`

- `usernamehw.errorlens`

- `vadimcn.vscode-lldb`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `fill-labs.dependi`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# cpp-clangd-crisp

jq -r '.[].identifier.id' profiles/cpp-clangd-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "cpp-clangd-crisp" --install-extension "{}"



# cpp-clangd-retina

jq -r '.[].identifier.id' profiles/cpp-clangd-retina/extensions.json \

  | xargs -n1 -I{} code --profile "cpp-clangd-retina" --install-extension "{}"

```



 






  C/C++ (cpptools) — cpp-intellisense-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `enkia.tokyo-night`

- `foxundermoon.shell-format`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `jeff-hykin.better-cpp-syntax`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vscode.cmake-tools`

- `ms-vscode.cpptools`

- `ms-vscode.cpptools-extension-pack`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `oderwat.indent-rainbow`

- `pkief.material-icon-theme`

- `redhat.vscode-yaml`

- `sdras.night-owl`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `timonwong.shellcheck`

- `twxs.cmake`

- `usernamehw.errorlens`

- `vadimcn.vscode-lldb`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `fill-labs.dependi`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# cpp-intellisense-crisp

jq -r '.[].identifier.id' profiles/cpp-intellisense-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "cpp-intellisense-crisp" --install-extension "{}"



# cpp-intellisense-retina

jq -r '.[].identifier.id' profiles/cpp-intellisense-retina/extensions.json \

  | xargs -n1 -I{} code --profile "cpp-intellisense-retina" --install-extension "{}"

```



 






  Java (Gradle‑first) — java-gradle-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `editorconfig.editorconfig`

- `enkia.tokyo-night`

- `foxundermoon.shell-format`

- `gabrielbb.vscode-lombok`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `naco-siren.gradle-language`

- `oderwat.indent-rainbow`

- `pkief.material-icon-theme`

- `pmd.pmd`

- `redhat.java`

- `redhat.vscode-xml`

- `redhat.vscode-yaml`

- `richardwillis.vscode-gradle`

- `sdras.night-owl`

- `shengchen.vscode-checkstyle`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `timonwong.shellcheck`

- `usernamehw.errorlens`

- `vscjava.vscode-gradle`

- `vscjava.vscode-java-debug`

- `vscjava.vscode-java-dependency`

- `vscjava.vscode-java-pack`

- `vscjava.vscode-java-test`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `fill-labs.dependi`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# java-gradle-crisp

jq -r '.[].identifier.id' profiles/java-gradle-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "java-gradle-crisp" --install-extension "{}"



# java-gradle-retina

jq -r '.[].identifier.id' profiles/java-gradle-retina/extensions.json \

  | xargs -n1 -I{} code --profile "java-gradle-retina" --install-extension "{}"

```



 






  Java (Maven‑first) — java-maven-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `editorconfig.editorconfig`

- `enkia.tokyo-night`

- `foxundermoon.shell-format`

- `gabrielbb.vscode-lombok`

- `github.vscode-github-actions`

- `github.vscode-pull-request-github`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `oderwat.indent-rainbow`

- `pkief.material-icon-theme`

- `pmd.pmd`

- `redhat.java`

- `redhat.vscode-xml`

- `redhat.vscode-yaml`

- `sdras.night-owl`

- `shengchen.vscode-checkstyle`

- `shirdows.vscode-maven-dependency-explorer`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `timonwong.shellcheck`

- `usernamehw.errorlens`

- `vscjava.vscode-java-debug`

- `vscjava.vscode-java-dependency`

- `vscjava.vscode-java-pack`

- `vscjava.vscode-java-test`

- `vscjava.vscode-maven`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `fill-labs.dependi`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# java-maven-crisp

jq -r '.[].identifier.id' profiles/java-maven-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "java-maven-crisp" --install-extension "{}"



# java-maven-retina

jq -r '.[].identifier.id' profiles/java-maven-retina/extensions.json \

  | xargs -n1 -I{} code --profile "java-maven-retina" --install-extension "{}"

```



 






  Java (Spring) — java-spring-(crisp|retina)



- `akamud.vscode-theme-onedark`

- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `dracula-theme.theme-dracula`

- `eamodio.gitlens`

- `editorconfig.editorconfig`

- `enkia.tokyo-night`

- `foxundermoon.shell-format`

- `gabrielbb.vscode-lombok`

- `github.vscode-github-actions`

- `mikestead.dotenv`

- `ms-azuretools.vscode-docker`

- `ms-vsliveshare.vsliveshare`

- `mutantdino.resourcemonitor`

- `oderwat.indent-rainbow`

- `pivotal.vscode-spring-boot`

- `pkief.material-icon-theme`

- `pmd.pmd`

- `redhat.java`

- `redhat.vscode-xml`

- `redhat.vscode-yaml`

- `richardwillis.vscode-gradle`

- `sdras.night-owl`

- `shengchen.vscode-checkstyle`

- `shirdows.vscode-maven-dependency-explorer`

- `sonarsource.sonarlint-vscode`

- `streetsidesoftware.code-spell-checker`

- `timonwong.shellcheck`

- `usernamehw.errorlens`

- `vscjava.vscode-gradle`

- `vscjava.vscode-java-debug`

- `vscjava.vscode-java-dependency`

- `vscjava.vscode-java-pack`

- `vscjava.vscode-java-test`

- `vscjava.vscode-maven`

- `vscjava.vscode-spring-boot-dashboard`

- `vscjava.vscode-spring-cloud`

- `vscjava.vscode-spring-initializr`

- `vscode-icons-team.vscode-icons`

- `zhuangtongfa.Material-theme`

- `github.vscode-pull-request-github`

- `fill-labs.dependi`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# java-spring-crisp

jq -r '.[].identifier.id' profiles/java-spring-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "java-spring-crisp" --install-extension "{}"



# java-spring-retina

jq -r '.[].identifier.id' profiles/java-spring-retina/extensions.json \

  | xargs -n1 -I{} code --profile "java-spring-retina" --install-extension "{}"

```



 




  AI (Copilot) — ai-profile-(crisp|retina)



- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `enkia.tokyo-night`

- `zhuangtongfa.Material-theme`

- `sdras.night-owl`

- `akamud.vscode-theme-onedark`

- `dracula-theme.theme-dracula`

- `pkief.material-icon-theme`

- `vscode-icons-team.vscode-icons`

- `eamodio.gitlens`

- `usernamehw.errorlens`

- `oderwat.indent-rainbow`

- `streetsidesoftware.code-spell-checker`

- `ms-vsliveshare.vsliveshare`

- `ms-azuretools.vscode-docker`

- `github.vscode-pull-request-github`

- `sonarsource.sonarlint-vscode`

- `mutantdino.resourcemonitor`

- `fill-labs.dependi`

- `mikestead.dotenv`

- `foxundermoon.shell-format`

- `timonwong.shellcheck`

- `redhat.vscode-yaml`

- `github.vscode-github-actions`

- `github.copilot`

- `github.copilot-chat`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# ai-profile-crisp

jq -r '.[].identifier.id' profiles/ai-profile-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "ai-profile-crisp" --install-extension "{}"



# ai-profile-retina

jq -r '.[].identifier.id' profiles/ai-profile-retina/extensions.json \

  | xargs -n1 -I{} code --profile "ai-profile-retina" --install-extension "{}"

```






  AI‑Plus (Copilot + Cody + Continue) — ai-plus-(crisp|retina)



- `catppuccin.catppuccin-vsc`

- `catppuccin.catppuccin-vsc-icons`

- `enkia.tokyo-night`

- `zhuangtongfa.Material-theme`

- `sdras.night-owl`

- `akamud.vscode-theme-onedark`

- `dracula-theme.theme-dracula`

- `pkief.material-icon-theme`

- `vscode-icons-team.vscode-icons`

- `eamodio.gitlens`

- `usernamehw.errorlens`

- `oderwat.indent-rainbow`

- `streetsidesoftware.code-spell-checker`

- `ms-vsliveshare.vsliveshare`

- `ms-azuretools.vscode-docker`

- `github.vscode-pull-request-github`

- `sonarsource.sonarlint-vscode`

- `mutantdino.resourcemonitor`

- `fill-labs.dependi`

- `mikestead.dotenv`

- `foxundermoon.shell-format`

- `timonwong.shellcheck`

- `redhat.vscode-yaml`

- `github.vscode-github-actions`

- `github.copilot`

- `github.copilot-chat`

- `sourcegraph.cody-ai`

- `continue.continue`

- `tamasfe.even-better-toml`



Install all (CLI):



```bash

# ai-plus-crisp

jq -r '.[].identifier.id' profiles/ai-plus-crisp/extensions.json \

  | xargs -n1 -I{} code --profile "ai-plus-crisp" --install-extension "{}"



# ai-plus-retina

jq -r '.[].identifier.id' profiles/ai-plus-retina/extensions.json \

  | xargs -n1 -I{} code --profile "ai-plus-retina" --install-extension "{}"

```



## Guides (Step‑by‑Step)



Below are copy‑pasteable shell snippets for each stack. Each block shows: compose → open (register) → install → a minimal smoke test. Replace `*-crisp` with `*-retina` if you prefer the HiDPI baseline.



### Web (Astro/Node)

Install Node LTS, compose/open the profile, install extensions, and scaffold an Astro app.



```bash

# 1) Node.js LTS (pick your favorite version manager)

#    macOS example with nvm:

export NVM_DIR="$HOME/.nvm" && [ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"

nvm install --lts && nvm use --lts

node -v && npm -v



# 2) Compose + open (register profile without installing extensions)

bash scripts/compose-settings.sh web-astro-crisp

vspcli --open-profiles --skip-install web-astro-crisp



# 3) Install extensions declared by the profile

bash scripts/install-extensions.sh web-astro-crisp



# 4) Create and run an Astro project

npm create astro@latest my-astro-app -- --template starter

cd my-astro-app

npm install

npm run dev



# Notes: Prettier/ESLint format on save for JS/TS/HTML/CSS/JSON.

# Astro files use the Astro formatter; Emmet works in .astro.

# Tailwind IntelliSense mapped for Astro.

```



### Java (jenv; Gradle/Maven/Spring)

Use jenv so profiles can resolve the active JDK automatically.



```bash

# 1) Install jenv and register JDKs (macOS example)

brew install jenv

echo 'export PATH="$HOME/.jenv/bin:$PATH"' >> ~/.zshrc

echo 'eval "$(jenv init -)"'          >> ~/.zshrc

source ~/.zshrc



jenv add /Library/Java/JavaVirtualMachines//Contents/Home

jenv global 



# 2) Compose + open (register), then install extensions

bash scripts/compose-settings.sh java-profile-crisp

vspcli --open-profiles --skip-install java-profile-crisp

bash scripts/install-extensions.sh java-profile-crisp



# Tips: use java-gradle-* / java-maven-* / java-spring-* for focused workflows.

# Profiles read the JDK via ${command:jenv.javaHome} — no manual JAVA_HOME.

```



### Rust

Install the toolchain and compose/open/install the profile.



```bash

# 1) Toolchain + components

curl https://sh.rustup.rs -sSf | sh -s -- -y

source "$HOME/.cargo/env"

rustup component add rust-src rustfmt clippy



# 2) Compose + open (register), then install extensions

bash scripts/compose-settings.sh rust-profile-crisp

vspcli --open-profiles --skip-install rust-profile-crisp

bash scripts/install-extensions.sh rust-profile-crisp



# Notes: rust-analyzer + clippy on save; CodeLLDB for debugging; Dependi + Even Better TOML.

```



### C/C++ (clangd or Microsoft cpptools)

Pick either clangd (fast/precise LSP) or cpptools (Microsoft IntelliSense). Install build tools, then compose/open/install.



```bash

# 1) Build tools (macOS examples)

brew install cmake ninja llvm   # clangd in LLVM for the clangd profile



# 2) Compose + open (clangd example) and install extensions

bash scripts/compose-settings.sh cpp-clangd-crisp

vspcli --open-profiles --skip-install cpp-clangd-crisp

bash scripts/install-extensions.sh cpp-clangd-crisp



# Alternative: Microsoft C/C++ IntelliSense profile

# bash scripts/compose-settings.sh cpp-intellisense-crisp

# vspcli --open-profiles --skip-install cpp-intellisense-crisp

# bash scripts/install-extensions.sh cpp-intellisense-crisp



# Tips: build dir defaults to ${workspaceFolder}/build (watcher excludes set).

# clangd profile disables Microsoft IntelliSense; cpptools uses CMake Tools provider

# and compile_commands.json for accurate navigation/completion.

```



### AI (Copilot)

Open the AI profile, install Copilot + Chat, then sign in when prompted.



```bash

vspcli --open-profiles --skip-install ai-profile-crisp

bash scripts/install-extensions.sh ai-profile-crisp



# Sign in to GitHub Copilot and Copilot Chat when prompted.

# Policy: other AI assistants are intentionally excluded.

```



## XDG vs Non‑XDG Environments



These profiles work whether you keep this repo under `~/.config/vscode` (XDG‑style) or anywhere else.



### Where profiles live (this repo)

- `profiles//extensions.json` declares the profile’s extensions

- `profiles//settings.json` is a symlink to `_merged/.json` (managed by the composer)



### Where VS Code stores profile state (editor cache)

When you open a profile with `code --profile `, VS Code registers it and caches profile data under your platform’s User directory:



| Platform | VS Code User directory |

|---|---|

| macOS | `~/Library/Application Support/Code/User` |

| Linux | `${XDG_CONFIG_HOME:-~/.config}/Code/User` |

| Windows | `%APPDATA%\Code\User` |



Our `open-profiles.sh` also copies the merged `settings.json` into VS Code’s cached profile directory (`User/profiles//settings.json`) when possible, so your window reflects new settings immediately.



### XDG‑style usage

```bash

# Keep repo under ~/.config/vscode (optional, but neat)

mkdir -p ~/.config && cd ~/.config

git clone git@github.com:artagon/artagon-vscode-profiles.git vscode

cd vscode

bash scripts/validate-json.sh && bash scripts/compose-settings.sh

vspcli --open-profiles --skip-install web-astro-crisp

```



### Non‑XDG usage

```bash

# Keep repo anywhere (e.g., ~/Projects)

git clone git@github.com:artagon/artagon-vscode-profiles.git ~/Projects/artagon-vscode-profiles

cd ~/Projects/artagon-vscode-profiles

bash scripts/validate-json.sh && bash scripts/compose-settings.sh

vspcli --open-profiles --skip-install web-astro-crisp



# Profiles still register in the VS Code User directory for your OS (table above).

```



> Note: Extensions are installed by VS Code into its extension directory and enabled per profile. The profile manifests in this repo remain the source of truth for what each profile should enable.



## Layout Overview



Directory tree (top‑level):



```

.

├─ _shared/           # editor baselines (crisp/retina)

├─ _overrides/        # per‑profile settings (strict JSON; supports "@extends")

├─ _merged/           # merged settings (generated)

├─ profiles/          # per‑profile extensions.json + settings symlink

├─ scripts/           # helpers (compose/export/validate/open/install, CLI)

├─ exports/           # .code-profile bundles (for VS Code import)

├─ agents/            # maintainer/LLM docs

├─ branding/          # social preview assets

└─ .github/           # issue/PR templates, CODEOWNERS, funding

```



Paths and purpose:



| Path | Purpose | Notes |

|---|---|---|

| `_shared/` | Base editor/terminal settings | JSONC files: `editor-crisp.jsonc`, `editor-retina.jsonc` |

| `_overrides/` | Per‑profile overrides | Strict JSON; supports `"@extends"` chains |

| `_merged/` | Generated merged settings | Do not edit; created by composer |

| `profiles/` | Profile manifests | `extensions.json` + `settings.json` symlink into `_merged/` |

| `scripts/` | Tooling scripts + CLI | compose/export/validate/open/install, git hooks, tests, `vspcli` |

| `exports/` | Portable bundles | Import via VS Code “Profiles: Import Profile” |

| `agents/` | Docs for maintainers/LLMs | Architecture + maintenance workflow |

| `branding/` | Social preview assets | `social-preview.svg` (export PNG, upload in repo settings) |

| `.github/` | Repo metadata | Issue/PR templates, CODEOWNERS, FUNDING |



Scripts quick reference:



| Script | Action | Example |

|---|---|---|

| `scripts/compose-settings.sh` | Merge shared + overrides → `_merged/` and refresh symlinks | `bash scripts/compose-settings.sh java-spring-*` |

| `scripts/export-profiles.sh` | Build `.code-profile` bundles | `bash scripts/export-profiles.sh web-astro-crisp` |

| `scripts/validate-json.sh` | Validate JSON/JSONC fragments and extensions lists | `bash scripts/validate-json.sh` |

| `scripts/open-profiles.sh` | Open/register profiles (optionally skip installs) | `scripts/open-profiles.sh --skip-install rust-profile-crisp` |

| `scripts/install-extensions.sh` | Install declared extensions (group filters supported) | `bash scripts/install-extensions.sh  --group General` |

| `scripts/vspcli` | Unified CLI for list/open/install/compose/export | `vspcli --open-profiles --skip-install ` |

| `scripts/tests/run.sh` | Smoke test: validate→compose→export→open (mock) | `bash scripts/tests/run.sh` |



## Standalone install (non-XDG environments)

1. Clone the repo wherever it is convenient (no need for `~/.config`). Example: `git clone https://… ~/src/vscode-profiles`.

2. From that directory, run `bash scripts/validate-json.sh` and `bash scripts/compose-settings.sh` to refresh `_merged/` and recreate the relative `profiles/*/settings.json` links.

3. Export the profiles you need via `bash scripts/export-profiles.sh` so coworkers can import `exports/.code-profile` directly inside VS Code (Profiles: Import Profile).

4. Optionally run `bash scripts/install-extensions.sh ` first so VS Code installs the declared extensions before importing.

5. Use CLI helpers via absolute paths (e.g., `~/src/vscode-profiles/scripts/vspcli --list`) or add the repo’s `scripts/` directory to `$PATH`. No additional environment variables or host-level symlinks are required.



## Common Tasks

> Workflow rule: break non-trivial requests into plan steps and, after finishing each step, immediately run `scripts/validate-json.sh` (plus `code --version` when CLI usage is involved) before continuing. This keeps JSON/CLI regressions localized to the step that introduced them.

1. **Plan & edit**: For non-trivial work, outline steps, then edit `_shared/`, `_overrides/`, or `profiles/*/extensions.json` as needed.

2. **Validate JSON**: `bash ~/.config/vscode/scripts/validate-json.sh`

3. **Compose settings**: `bash ~/.config/vscode/scripts/compose-settings.sh` (optionally pass profile names).

4. **Export profiles**: `bash ~/.config/vscode/scripts/export-profiles.sh`

5. **Install extensions for a profile** (first-time setup / new machine): `bash ~/.config/vscode/scripts/install-extensions.sh ` (or `vsext-install `). The installer groups output by stack (AI, CMake, Java, Rust, General) so it’s easy to see what’s being installed. Use `--group ` (repeatable) to install only a subset (e.g., `--group AI --group Java`), or pass `all` as the profile name to cover every profile at once. Run this the first time you open a profile so VS Code has the declared extensions ready.

6. **Smoke tests**: `bash ~/.config/vscode/scripts/tests/run.sh` (validates, composes, exports, then mocks `code --profile` calls and checks logs).

7. **Open profiles**: `bash ~/.config/vscode/scripts/open-profiles.sh [profile ...]` to register either every profile (no args) or a filtered list with the VS Code CLI. The script installs extensions (set `VSCODE_SKIP_EXTENSION_INSTALL=1` to skip during automation) **and** now copies the freshly merged `profiles//settings.json` into VS Code’s cached profile directory (uses `jq` + `~/Library/Application Support/Code/User` on macOS; override with `VSCODE_USER_DIR` if needed) so the editor immediately reflects the latest fonts/theme tweaks even if you previously imported a profile snapshot.

8. **Import a `.code-profile` bundle via CLI**: `bash ~/.config/vscode/scripts/import-profile.sh  ` (or `vspcli --profile-import  `). The importer writes the bundle’s settings into VS Code’s cached profile store and installs every listed extension so teammates can restore shared profiles headlessly.

9. **Add AI tooling everywhere**: run `bash ~/.config/vscode/scripts/install-extensions.sh ` after pulling the repo to ensure AI extensions (Copilot, Claude, Gemini, Continue, Codeium, OpenAI, Tabnine, GitHub Actions helpers, etc.) are installed for that profile. All non-AI profiles now include the AI bundle directly in their `extensions.json`.



### Shell helpers

- Bash/Zsh: defined in `~/.config/shell/xdg.sh` and sourced from the respective rc files.

- Fish: defined in `~/.config/fish/conf.d/xdg-vscode.fish`.

- Commands:

- `vsp  [path]` / `vspi  [path]` — call `code --profile` / `code-insiders --profile`.

- `vspl` / `vspli` — list the managed profiles (reads `profiles/`).

- `vsext-list ` — list extensions currently installed for a profile via `code --profile ... --list-extensions`.

- `vsext-install ` — run the installer script to synchronize extensions declared in `profiles//extensions.json`.

- `vsregen []` — run `validate-json.sh` + `compose-settings.sh` (all profiles if none specified).

- `vsexport []` — run `export-profiles.sh` (all profiles if none specified).

- `scripts/vspcli` provides the same workflows via a getopt-style CLI.



## Git Hooks

Enable the provided hooks so commits automatically validate and rebuild profiles:

```bash

git config core.hooksPath ~/.config/vscode/scripts/git-hooks

```



## Java & jenv

Shell init enables `jenv enable-plugin export`, so `JAVA_HOME` always matches the active jenv JDK. Every Java-oriented profile (including Gradle, Maven, and Spring variants) reads `${env:JAVA_HOME}` for JDT LS, Gradle, Maven, and Spring tooling—no manual path edits required.



## Rust toolchain prerequisites

Rust-oriented profiles expect the following components to be installed once per host:

```bash

rustup component add rust-src rustfmt clippy

```

`rust-src` powers IntelliSense/hover docs, while `rustfmt` and `clippy` back format-on-save and linting tasks.

Make sure the VS Code extension `rust-lang.rust-analyzer` remains enabled for the Rust profiles (disabling it once disables it per-profile).



### Quick setup

- Run `bash ~/.config/vscode/scripts/setup-rust-toolchain.sh [profile]` to install the required rustup components and synchronize VS Code extensions for the given profile (defaults to `rust-profile-crisp`).

- Copy `profiles/rust-profile-*/tasks.example.json` into `.vscode/tasks.json` if you want Cargo build/test/clippy commands available in the VS Code Tasks UI.



## Java toolchain automation

- Run `bash ~/.config/vscode/scripts/setup-java-toolchain.sh  [workspace]` to ensure extensions are installed for the Java profile and (optionally) copy the tasks template into your workspace `.vscode/tasks.json`. The script checks `jenv`/`JAVA_HOME` and reminds you to enable the export plugin if needed.

- Tasks templates live under `profiles/java-*/tasks.example.json` (Gradle-only, Maven-only, or combined depending on the profile).



## AI collaboration profiles

- `ai-profile-crisp` and `ai-profile-retina` ship with the popular AI coding extensions (GitHub Copilot + Copilot Chat, Claude Code, Gemini AI Studio, Continue, Codeium, Tabnine, YAML/GitHub Actions helpers, etc.).

- Use `vsp ai-profile-crisp ` (or retina) to open a workspace with the command center targeting AI chats by default.

- First-time setup: `bash ~/.config/vscode/scripts/install-extensions.sh ai-profile-crisp` so VS Code installs the bundle on your machine. Sign in to Copilot, Claude, Gemini, etc., via their respective panels afterward.



## CLI helper (vspcli)

`scripts/vspcli` exposes common operations from the terminal:



```bash

vspcli --list

vspcli --install ai-profile-crisp

vspcli --open ai-profile-crisp /path/to/workspace

vspcli --compose cpp-clangd cpp-intellisense

vspcli --export java-profile-crisp

vspcli --install-ext rust-profile-retina github.copilot

vspcli --profile-import rust-profile-retina ~/Downloads/team-standard.code-profile

vspcli --open-profiles rust-profile-retina java-profile-retina

vspcli --install all

vspcli --install-groups java-profile-crisp AI Rust

```



Combine flags as needed; run `vspcli --help` for details.



Both the script and CLI accept `--group` filters (`AI`, `CMake`, `Java`, `Rust`, `General`). Example: `vspcli --install java-profile-crisp --group AI --group Java` installs only those stacks, while `vspcli --install all` covers every profile.



Install shell completions (optional):

```bash

vspcli --completion bash  >> ~/.config/shell/completions/vspcli.bash

vspcli --completion zsh   >> ~/.config/zsh/completions/_vspcli

vspcli --completion fish  >> ~/.config/fish/completions/vspcli.fish

```

Adjust the target paths to whatever your shell sources so the CLI works even on machines where the helper functions are absent.



## Adding a Profile

1. Create `profiles//extensions.json` describing required extensions.

2. Add `_overrides/.jsonc` (strict JSON). Use `"@extends"` to reuse existing fragments if possible.

3. Run the compose + export scripts and smoke tests (steps above).

4. Optionally generate `exports/.code-profile` via the export script for easy sharing.



For more detail, see `agents/project.md` (architecture) and `agents/instructions.md` (maintenance workflow). Host-wide (non-editor-specific) policies remain in `~/.config/agents/project.md` and `~/.config/agents/instructions.md`; update those whenever a change should apply beyond VS Code.

## Custom toolchains (C/C++)

By default the C/C++ profiles rely on whatever toolchain is on `$PATH` (e.g., `/usr/bin/clang`). For custom setups:



1. Copy `profiles//cmake-kits.example.json` to `.vscode/cmake-kits.json`. Use `scripts/setup-cpp-toolchain.sh ` to automate this copy (also populates `cmake/toolchains/`).

2. Edit the kits with your compiler paths (Homebrew LLVM, MSVC). Optional: supply a toolchain file under `cmake/toolchains/` and reference it from the kit.

3. Copy `profiles//cmake/tasks.example.json` to `.vscode/tasks.json` if you want ready-made configure/build/test commands on the command palette.

4. Use `CMake: Select Kit` in VS Code to pick the kit locally; avoid committing machine-specific paths to `_overrides`.