From b750536e294a050981b1f30f230706687cd59dc9 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Thu, 2 Apr 2026 21:24:02 -0400 Subject: [PATCH 01/17] Move claude code to Getting Started Tools. --- docs/contributing/ai.md | 217 ---------------------------- docs/getting-started/tools/index.md | 66 +++++++-- 2 files changed, 55 insertions(+), 228 deletions(-) diff --git a/docs/contributing/ai.md b/docs/contributing/ai.md index 0954e42df..28f8faa37 100644 --- a/docs/contributing/ai.md +++ b/docs/contributing/ai.md @@ -46,220 +46,3 @@ Our primary AI tooling stack centers around Anthropic's Claude, which offers bot language model and flexible integration capabilities through the Model Context Protocol (MCP). This allows us to create custom workflows and integrate with our existing development tools while maintaining control over data privacy and security. - -## Installing Claude Code and Claude Desktop - -### Claude Code - -Claude Code is Anthropic's official CLI tool that brings Claude's capabilities directly to your -terminal. It's ideal for developers who prefer command-line interfaces and want to integrate AI -assistance into their terminal-based workflows. - -#### Installation - -1. [Node.js](https://nodejs.org/) v18 or higher is available -2. Install via NPM `npm install -g @anthropic-ai/claude-code` or Homebrew - `brew install --cask claude-code` -3. Configure your API key: - - ```bash - claude configure - ``` - - Walk through the process to sign into the Anthropic Console via SSO and authenticate your local - client. - -#### Basic usage - -```bash -# Start an interactive session -claude - -# Ask a question -claude "How do I add a feature flag around my changes?" -``` - -### Claude Desktop - -Claude Desktop provides a graphical interface for interacting with Claude, ideal for developers who -prefer a dedicated application with rich formatting and file management capabilities. - -#### Installation - -Install via [claude.ai/download](https://claude.ai/download) or Homebrew `brew install claude` - -- Launch Claude Desktop -- Sign in with your Anthropic account via SSO -- Configure your workspace preferences -- Enable MCP server connections in Settings → Developer → MCP Servers - -## MCP servers and extensions - -Model Context Protocol (MCP) servers extend Claude's capabilities by providing access to external -tools, APIs, and data sources. They enable Claude to interact with your development environment, -databases, and other services while maintaining security boundaries. - -### Bitwarden AI plugin marketplace - -Bitwarden maintains a curated [marketplace of AI plugins](https://github.com/bitwarden/ai-plugins) -specifically designed for our development workflows. This marketplace was created to provide -quality-controlled, security-reviewed plugins that follow Bitwarden's coding standards and security -requirements. All marketplace plugins are maintained by the Bitwarden team and include comprehensive -documentation, testing, and security validation. - -To use the marketplace with Claude Code: - -```bash -/plugin marketplace add bitwarden/ai-plugins -``` - -### Understanding MCP servers - -MCP servers are separate processes that communicate with Claude through a standardized protocol. -They can: - -- Access local file systems and databases -- Execute commands and scripts -- Integrate with third-party APIs -- Provide specialized reasoning capabilities - -We recommend at least two be installed by everyone: - -### Installing Sequential Thinking MCP server - -The Sequential Thinking server enhances Claude's problem-solving capabilities by providing -structured, step-by-step reasoning for complex tasks. - -#### Claude Code - -```bash -claude mcp add --scope user sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking -``` - -#### Claude Desktop - -Edit your `~/.claude.json`, go to the `mcpServers` section and add: - -```json -"sequential-thinking": { - "type": "stdio", - "command": "npx", - "args": [ - "-y", - "@modelcontextprotocol/server-sequential-thinking" - ] - } -``` - -Restart Claude Desktop to activate the server. - -### Installing Memory MCP server - -The Memory server provides Claude with persistent memory capabilities, allowing it to remember -context across sessions and maintain a knowledge graph of your projects. - -#### Claude Code - -```bash -claude mcp add --scope user memory -- npx -y @modelcontextprotocol/server-memory -``` - -#### Claude Desktop - -Edit your `~/.claude.json`, go to the `mcpServers` section and add: - -```json -"memory": { - "type": "stdio", - "command": "npx", - "args": [ - "-y", - "@modelcontextprotocol/server-memory" - ] - } -``` - -Restart Claude Desktop to activate the server. - -### Verifying installations - -#### Claude Code - -```bash -claude mcp list -``` - -#### Claude Desktop - -1. Open Claude Desktop -2. Start a new conversation -3. Type: "Can you list your available MCP servers?" -4. Claude should respond with the configured servers - -### Troubleshooting - -Common issues and solutions: - -**Server not starting**: - -- Verify NPM packages are installed globally -- Check Node version (must be 18+) -- Review server logs in `~/.claude-code/logs/` or Claude Desktop's developer console - -**Permission errors**: - -- Ensure data directories have proper permissions -- On macOS/Linux: `chmod 755 ~/.claude-memory` - -**Configuration not loading**: - -- Validate JSON syntax in configuration files -- Restart Claude Code or Claude Desktop after configuration changes - -### Best practices - -**Security considerations**: - -- Only install MCP servers from trusted sources -- Review server permissions and capabilities before installation: - - Examine the server's source code or documentation to understand what file system access it - requires - - Verify what external APIs or services the server connects to - - Check if the server executes system commands and understand which ones - - Confirm whether the server stores persistent data and where it's stored - - Review network permissions and ensure the server only communicates with expected endpoints - - Validate that the server follows principle of least privilege -- Use trusted LLM providers and models: - - Prefer established providers with strong security track records (e.g., Anthropic) - - Verify the provider's data handling policies and ensure they align with Bitwarden's security - requirements - - Confirm that your API keys and credentials are stored securely - - Understand whether your prompts and code are used for model training (opt out if possible) - - Use enterprise or business tier services when available for enhanced security guarantees -- Core model usage guidelines: - - Use the latest stable model versions to benefit from security improvements and bug fixes - - Avoid deprecated or experimental models in production workflows - - Be aware of model capabilities and limitations - not all models are suitable for code generation - - Consider model context windows and token limits when designing workflows - - Use model-specific features (like Claude's extended thinking) appropriately for complex tasks - - Monitor model output for hallucinations or incorrect information, especially in - security-critical code -- Regularly update servers to get security patches - -**Performance optimization**: - -- Limit the number of active servers to those you actively use -- Monitor resource usage, especially for memory-intensive servers -- Configure appropriate timeouts for long-running operations - -**Data management**: - -- Regularly backup memory server data directories -- Clear old session data periodically to maintain performance -- Use project-specific memory contexts when appropriate - -**Integration with development workflow**: - -- Configure project-specific MCP servers in repository `.claude/` directories -- Document custom MCP server requirements in project README files -- Share MCP configurations with team members for consistency diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 4336425dc..2aa1d655e 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -4,19 +4,18 @@ sidebar_position: 1 # Tools -## Operating system +:::warning Operating system assumptions -All Bitwarden developers are issued with a MacBook. The tooling recommendations and instructions in -this documentation assume that you’re using macOS. This may require some adaptation if you’re using -a different operating system. +The tooling recommendations and instructions in this documentation assume that you’re using macOS. +This may require some adaptation if you’re using a different operating system. -## Recommended tools +::: The following tools are strongly recommended as part of the “standard” developer setup. We recommend that any new Bitwarden developer install all of them as part of setting up their local development environment. -### IDEs +## IDEs - [Visual Studio Code](https://code.visualstudio.com/) - used for all Typescript projects. Suboptimal for C#. Be sure to install [extensions](#visual-studio-code-extensions) @@ -25,7 +24,7 @@ environment. - [Xcode](https://developer.apple.com/xcode/) - required for iOS Mobile development and Safari web extension -### Local environment +## Local environment - [Homebrew](https://brew.sh/) - package manager for macOS - [Iterm2](https://iterm2.com/) (available via Homebrew) - a better terminal emulator @@ -43,9 +42,8 @@ environment. [rustup](https://rustup.rs/)) - [Git](https://git-scm.com) - [Commit signing](../../contributing/commit-signing.mdx) is strongly recommended -- [AI tools](../../contributing/ai.md) -### Mobile +## Mobile - [Android Studio](https://developer.android.com/studio/) - Nice for setting up and running Android Simulators @@ -53,7 +51,7 @@ environment. - [Apple Icons Generator Gist](https://gist.github.com/brutella/0bcd671a9e4f63edc12e) - Script to generate Apple icons from an image -### Databases +## Databases - [MSSQL VSCode Extension](https://marketplace.visualstudio.com/items?itemName=ms-mssql.mssql) for working with your local SQL Server @@ -61,7 +59,7 @@ environment. - [MySQLWorkbench](https://www.mysql.com/products/workbench/) - Useful for fiddling with MySQL db - [SQLiteStudio](https://www.sqlitestudio.pl/) - Useful for fiddling with SQLite db -### Visual Studio Code Extensions +## Visual Studio Code extensions There are some vs code extensions that are life-savers in our line of work. A list of highly recommended ones include the following: @@ -110,6 +108,52 @@ recommended ones include the following: - [PostgreSQL](https://marketplace.visualstudio.com/items?itemName=ckolkman.vscode-postgres) - syntax highlighting for PostgreSQL + + +## AI tools + +:::tip + +To learn more about how we use AI tools at Bitwarden, see our [AI](../../contributing/ai.md) +documentation. This page specifies how to configure AI tooling for development. + +::: + +### Claude Code + +Claude Code is Anthropic's official CLI tool that brings Claude's capabilities directly to your +terminal. It's ideal for developers who prefer command-line interfaces and want to integrate AI +assistance into their terminal-based workflows. + +#### Installation + +Follow the installation instructions [here](https://code.claude.com/docs/en/quickstart) for your OS +and interface of choice. When prompted, sign into the Anthropic Console via SSO and authenticate +your local client. + +#### Basic usage + +We recommend that you start with +[common workflows](https://code.claude.com/docs/en/common-workflows) and +[best practices](https://code.claude.com/docs/en/best-practices) from Anthropic to understand how to +use Claude Code. + +### Bitwarden AI plugin marketplace + +Bitwarden maintains a curated [marketplace of AI plugins](https://github.com/bitwarden/ai-plugins) +specifically designed for our development workflows. This marketplace was created to provide +quality-controlled, security-reviewed plugins that follow Bitwarden's coding standards and security +requirements. All marketplace plugins are maintained by the Bitwarden team and include comprehensive +documentation, testing, and security validation. + +To use the marketplace with Claude Code: + +```bash +/plugin marketplace add bitwarden/ai-plugins +``` + + + ## Optional tools The following tools may be useful depending on your preferences or what you’re developing. From f5bc888fe0f4439b323f37b1c34da6b4a3b13f7d Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Thu, 2 Apr 2026 21:36:45 -0400 Subject: [PATCH 02/17] Cleanup. --- docs/getting-started/tools/index.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 2aa1d655e..8a178b857 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -121,9 +121,8 @@ documentation. This page specifies how to configure AI tooling for development. ### Claude Code -Claude Code is Anthropic's official CLI tool that brings Claude's capabilities directly to your -terminal. It's ideal for developers who prefer command-line interfaces and want to integrate AI -assistance into their terminal-based workflows. +We use Claude Code as our primary AI tool for development workflows, including planning work, +exploring the codebase, and proposing solutions. #### Installation @@ -131,6 +130,9 @@ Follow the installation instructions [here](https://code.claude.com/docs/en/quic and interface of choice. When prompted, sign into the Anthropic Console via SSO and authenticate your local client. +Depending on your IDE of choice, you may also want to integrate Claude Code into your development +environment. See [VS Code](https://code.claude.com/docs/en/vs-code) instructions, for example. + #### Basic usage We recommend that you start with @@ -146,7 +148,7 @@ quality-controlled, security-reviewed plugins that follow Bitwarden's coding sta requirements. All marketplace plugins are maintained by the Bitwarden team and include comprehensive documentation, testing, and security validation. -To use the marketplace with Claude Code: +You should install the marketplace plugins using the `/plugin` command: ```bash /plugin marketplace add bitwarden/ai-plugins From b979585b5ecfd2fb088643c26fb53d85de6d6697 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Thu, 2 Apr 2026 21:44:38 -0400 Subject: [PATCH 03/17] Phrasing. --- docs/getting-started/tools/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 8a178b857..ca6f4c552 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -137,8 +137,8 @@ environment. See [VS Code](https://code.claude.com/docs/en/vs-code) instructions We recommend that you start with [common workflows](https://code.claude.com/docs/en/common-workflows) and -[best practices](https://code.claude.com/docs/en/best-practices) from Anthropic to understand how to -use Claude Code. +[best practices](https://code.claude.com/docs/en/best-practices) from Anthropic for learning how to +start using Claude for development. ### Bitwarden AI plugin marketplace From dddadbf297ec01777d92ec05d73b98aeaf85c3d0 Mon Sep 17 00:00:00 2001 From: Todd Martin <106564991+trmartin4@users.noreply.github.com> Date: Sat, 4 Apr 2026 18:08:35 -0400 Subject: [PATCH 04/17] Condensed verbiage. Co-authored-by: Mick Letofsky --- docs/getting-started/tools/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index ca6f4c552..fbeadf7c6 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -11,7 +11,7 @@ This may require some adaptation if you’re using a different operating system. ::: -The following tools are strongly recommended as part of the “standard” developer setup. We recommend +The following tools make up the standard Bitwarden developer setup and should be installed as part of your local development environment. that any new Bitwarden developer install all of them as part of setting up their local development environment. From 50aedd108348703ec2cee13df5c477dcbff02b2d Mon Sep 17 00:00:00 2001 From: Todd Martin <106564991+trmartin4@users.noreply.github.com> Date: Sat, 4 Apr 2026 18:09:06 -0400 Subject: [PATCH 05/17] Removed specific planning guidance. Co-authored-by: Mick Letofsky --- docs/getting-started/tools/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index fbeadf7c6..e62e8a8ae 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -121,7 +121,7 @@ documentation. This page specifies how to configure AI tooling for development. ### Claude Code -We use Claude Code as our primary AI tool for development workflows, including planning work, +We use Claude Code as our primary AI tool for development workflows. exploring the codebase, and proposing solutions. #### Installation From bc006c1bc88ebe0d32ac9cd9c4810f0e43051761 Mon Sep 17 00:00:00 2001 From: Todd Martin <106564991+trmartin4@users.noreply.github.com> Date: Sat, 4 Apr 2026 18:09:53 -0400 Subject: [PATCH 06/17] Clarified authentication steps. Co-authored-by: Mick Letofsky --- docs/getting-started/tools/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index e62e8a8ae..9a099c96c 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -126,7 +126,7 @@ exploring the codebase, and proposing solutions. #### Installation -Follow the installation instructions [here](https://code.claude.com/docs/en/quickstart) for your OS +Follow the installation instructions [here](https://code.claude.com/docs/en/quickstart). When prompted, sign into the Anthropic Console via SSO and authenticate your local client. and interface of choice. When prompted, sign into the Anthropic Console via SSO and authenticate your local client. From 0d1809d579ad55137937238115e996a522a60fa4 Mon Sep 17 00:00:00 2001 From: Todd Martin <106564991+trmartin4@users.noreply.github.com> Date: Sat, 4 Apr 2026 18:10:18 -0400 Subject: [PATCH 07/17] Strengthened suggestion to install in IDE. Co-authored-by: Mick Letofsky --- docs/getting-started/tools/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 9a099c96c..37aa60354 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -130,7 +130,7 @@ Follow the installation instructions [here](https://code.claude.com/docs/en/quic and interface of choice. When prompted, sign into the Anthropic Console via SSO and authenticate your local client. -Depending on your IDE of choice, you may also want to integrate Claude Code into your development +We also recommend integrating Claude Code into your IDE. See [VS Code](https://code.claude.com/docs/en/vs-code) for setup instructions. environment. See [VS Code](https://code.claude.com/docs/en/vs-code) instructions, for example. #### Basic usage From c0e08da57c6a42ff6ff9d165a77702f7b3fcc083 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sat, 4 Apr 2026 18:14:26 -0400 Subject: [PATCH 08/17] Updated plugin verbiage. --- docs/getting-started/tools/index.md | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 37aa60354..996ea8eda 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -11,9 +11,9 @@ This may require some adaptation if you’re using a different operating system. ::: -The following tools make up the standard Bitwarden developer setup and should be installed as part of your local development environment. -that any new Bitwarden developer install all of them as part of setting up their local development -environment. +The following tools make up the standard Bitwarden developer setup and should be installed as part +of your local development environment. that any new Bitwarden developer install all of them as part +of setting up their local development environment. ## IDEs @@ -121,17 +121,19 @@ documentation. This page specifies how to configure AI tooling for development. ### Claude Code -We use Claude Code as our primary AI tool for development workflows. -exploring the codebase, and proposing solutions. +We use Claude Code as our primary AI tool for development workflows. exploring the codebase, and +proposing solutions. #### Installation -Follow the installation instructions [here](https://code.claude.com/docs/en/quickstart). When prompted, sign into the Anthropic Console via SSO and authenticate your local client. -and interface of choice. When prompted, sign into the Anthropic Console via SSO and authenticate -your local client. +Follow the installation instructions [here](https://code.claude.com/docs/en/quickstart). When +prompted, sign into the Anthropic Console via SSO and authenticate your local client. and interface +of choice. When prompted, sign into the Anthropic Console via SSO and authenticate your local +client. -We also recommend integrating Claude Code into your IDE. See [VS Code](https://code.claude.com/docs/en/vs-code) for setup instructions. -environment. See [VS Code](https://code.claude.com/docs/en/vs-code) instructions, for example. +We also recommend integrating Claude Code into your IDE. See +[VS Code](https://code.claude.com/docs/en/vs-code) for setup instructions. environment. See +[VS Code](https://code.claude.com/docs/en/vs-code) instructions, for example. #### Basic usage @@ -142,11 +144,8 @@ start using Claude for development. ### Bitwarden AI plugin marketplace -Bitwarden maintains a curated [marketplace of AI plugins](https://github.com/bitwarden/ai-plugins) -specifically designed for our development workflows. This marketplace was created to provide -quality-controlled, security-reviewed plugins that follow Bitwarden's coding standards and security -requirements. All marketplace plugins are maintained by the Bitwarden team and include comprehensive -documentation, testing, and security validation. +Bitwarden maintains a curated marketplace of AI plugins designed for our development workflows in +our [marketplace](https://github.com/bitwarden/ai-plugins). You should install the marketplace plugins using the `/plugin` command: From 86c5f48843b08d2085f6026ed7048b49766db268 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sat, 4 Apr 2026 18:15:02 -0400 Subject: [PATCH 09/17] Reduced duplication of marketplace term --- docs/getting-started/tools/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 996ea8eda..978f043c0 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -144,8 +144,8 @@ start using Claude for development. ### Bitwarden AI plugin marketplace -Bitwarden maintains a curated marketplace of AI plugins designed for our development workflows in -our [marketplace](https://github.com/bitwarden/ai-plugins). +Bitwarden maintains a curated set of AI plugins designed for our development workflows in our +[marketplace](https://github.com/bitwarden/ai-plugins). You should install the marketplace plugins using the `/plugin` command: From 1563f9aa7d6cf23010dcb48b7a85a4fde6dcd201 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sat, 4 Apr 2026 18:16:33 -0400 Subject: [PATCH 10/17] Updated broken link. --- docs/contributing/template-repository.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/template-repository.md b/docs/contributing/template-repository.md index db9035bd4..096bb0b0b 100644 --- a/docs/contributing/template-repository.md +++ b/docs/contributing/template-repository.md @@ -123,7 +123,7 @@ Initial content placeholders provide AI assistance and automated code reviews: ``` Project settings contain useful configuration such as -[our marketplace](./ai.md#bitwarden-ai-plugin-marketplace). +[our marketplace](./../getting-started/tools/index.md#bitwarden-ai-plugin-marketplace). ### Automated reviews From cadd7606a8ec1b0245744ca5ab6c6a3cf500d83e Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sat, 4 Apr 2026 18:36:31 -0400 Subject: [PATCH 11/17] Prettier changes. --- docs/contributing/pull-requests/code-review.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/pull-requests/code-review.md b/docs/contributing/pull-requests/code-review.md index 0f36052e6..4d0c1312c 100644 --- a/docs/contributing/pull-requests/code-review.md +++ b/docs/contributing/pull-requests/code-review.md @@ -116,7 +116,7 @@ informational notes or suggestions: | 🎨 `:art:` | Suggestion or improvement | | ❌ `:x:` / ⚠️ `:warning:` | Significant concern that should be addressed | | 🌱 `:seedling:` / ♻️ `:recycle:` | Future work or technical debt to address later | -| ⛏ `:pick:` | Minor nitpick | +| ⛏ `:pick:` | Minor nitpick | ### Review statuses From 25faf5e02c0f16fb611d08a09e9b112c7d40ff5e Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sat, 4 Apr 2026 21:30:56 -0400 Subject: [PATCH 12/17] Fixed duplicates. --- docs/getting-started/tools/index.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 978f043c0..250f83f00 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -12,8 +12,7 @@ This may require some adaptation if you’re using a different operating system. ::: The following tools make up the standard Bitwarden developer setup and should be installed as part -of your local development environment. that any new Bitwarden developer install all of them as part -of setting up their local development environment. +of your local development environment. ## IDEs @@ -121,19 +120,15 @@ documentation. This page specifies how to configure AI tooling for development. ### Claude Code -We use Claude Code as our primary AI tool for development workflows. exploring the codebase, and -proposing solutions. +We use Claude Code as our primary AI tool for development workflows. #### Installation Follow the installation instructions [here](https://code.claude.com/docs/en/quickstart). When -prompted, sign into the Anthropic Console via SSO and authenticate your local client. and interface -of choice. When prompted, sign into the Anthropic Console via SSO and authenticate your local -client. +prompted, sign into the Anthropic Console via SSO and authenticate your local client. We also recommend integrating Claude Code into your IDE. See -[VS Code](https://code.claude.com/docs/en/vs-code) for setup instructions. environment. See -[VS Code](https://code.claude.com/docs/en/vs-code) instructions, for example. +[VS Code](https://code.claude.com/docs/en/vs-code) for setup instructions. #### Basic usage From 6ef8bd396ce841367eb2b945a81ce5ec72a73361 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Sat, 4 Apr 2026 22:03:11 -0400 Subject: [PATCH 13/17] Linting. --- docs/contributing/pull-requests/code-review.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/pull-requests/code-review.md b/docs/contributing/pull-requests/code-review.md index 4d0c1312c..0f36052e6 100644 --- a/docs/contributing/pull-requests/code-review.md +++ b/docs/contributing/pull-requests/code-review.md @@ -116,7 +116,7 @@ informational notes or suggestions: | 🎨 `:art:` | Suggestion or improvement | | ❌ `:x:` / ⚠️ `:warning:` | Significant concern that should be addressed | | 🌱 `:seedling:` / ♻️ `:recycle:` | Future work or technical debt to address later | -| ⛏ `:pick:` | Minor nitpick | +| ⛏ `:pick:` | Minor nitpick | ### Review statuses From 0dfefa65a962d3c3cf443fad42d82e3e499a2ec0 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Tue, 7 Apr 2026 21:50:55 -0400 Subject: [PATCH 14/17] Added link to setup from AI page. --- docs/contributing/ai.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/contributing/ai.md b/docs/contributing/ai.md index 28f8faa37..8c20e94c5 100644 --- a/docs/contributing/ai.md +++ b/docs/contributing/ai.md @@ -46,3 +46,11 @@ Our primary AI tooling stack centers around Anthropic's Claude, which offers bot language model and flexible integration capabilities through the Model Context Protocol (MCP). This allows us to create custom workflows and integrate with our existing development tools while maintaining control over data privacy and security. + +:::tip Setting up AI tooling + +To set up AI tooling in your development environment, see the +[[AI Tools](./../getting-started/tools/index.md#ai-tools) instructions of our Getting Started +section. + +::: From c6d660da0b9570e706748d8e6eafc6c8861c3b2b Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Wed, 8 Apr 2026 08:27:19 -0400 Subject: [PATCH 15/17] Fixed bracket. --- docs/contributing/ai.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/ai.md b/docs/contributing/ai.md index 8c20e94c5..bab6290e8 100644 --- a/docs/contributing/ai.md +++ b/docs/contributing/ai.md @@ -50,7 +50,7 @@ maintaining control over data privacy and security. :::tip Setting up AI tooling To set up AI tooling in your development environment, see the -[[AI Tools](./../getting-started/tools/index.md#ai-tools) instructions of our Getting Started +[AI Tools](./../getting-started/tools/index.md#ai-tools) instructions of our Getting Started section. ::: From 60dc9cc974f55adb3a7c8be1be3492bd0279e5f6 Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Thu, 9 Apr 2026 10:24:45 -0400 Subject: [PATCH 16/17] Updated to reference plugin README. --- docs/getting-started/tools/index.md | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index 250f83f00..d15532a1f 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -142,13 +142,8 @@ start using Claude for development. Bitwarden maintains a curated set of AI plugins designed for our development workflows in our [marketplace](https://github.com/bitwarden/ai-plugins). -You should install the marketplace plugins using the `/plugin` command: - -```bash -/plugin marketplace add bitwarden/ai-plugins -``` - - +See the [`README`](https://github.com/bitwarden/ai-plugins/tree/main?tab=readme-ov-file#usage) in +the `ai-plugins` repo for installation and setup instructions. ## Optional tools From 38dbe565d358b55ea071b667d7108f4b55821a7a Mon Sep 17 00:00:00 2001 From: Todd Martin Date: Thu, 9 Apr 2026 10:27:50 -0400 Subject: [PATCH 17/17] Added back missing tag. --- docs/getting-started/tools/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/getting-started/tools/index.md b/docs/getting-started/tools/index.md index d15532a1f..0a2b6779d 100644 --- a/docs/getting-started/tools/index.md +++ b/docs/getting-started/tools/index.md @@ -145,6 +145,8 @@ Bitwarden maintains a curated set of AI plugins designed for our development wor See the [`README`](https://github.com/bitwarden/ai-plugins/tree/main?tab=readme-ov-file#usage) in the `ai-plugins` repo for installation and setup instructions. + + ## Optional tools The following tools may be useful depending on your preferences or what you’re developing.