Skip to content

Add Environment Setup section to Dev Agent docs #35737

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
chrissmiller merged 2 commits into from
Apr 10, 2026
Merged

Add Environment Setup section to Dev Agent docs #35737

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7d43130
Promote Environment Setup to ## heading level
datadog-prod-us1-5[bot] Apr 2, 2026
871a129
Add yarnpkg and sum.golang.org to allowlist
datadog-prod-us1-6[bot] Apr 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 21 additions & 17 deletions content/en/bits_ai/bits_ai_dev_agent/setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,37 +49,41 @@

**Note**: If auto-push is disabled, you must review and approve code in Datadog before the Dev Agent can push it.

### Configure custom instructions

The Dev Agent ingests custom instruction files from your repository, including:

Check notice on line 54 in content/en/bits_ai/bits_ai_dev_agent/setup.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.sentencelength 

Suggestion: Try to keep your sentence length to 25 words or fewer.

- `.cursorrules`
- `.windsurfrules`
- `copilot-instructions.md`
- `CLAUDE.md`
- `AGENTS.md`
- `agent.md`


You can also define global custom instructions, which apply to all Dev Agent sessions, in **Bits AI Dev** > [**Settings**][12] > **General**, in the **Global Agent Instructions** section.

## Environment setup

Configure the Dev Agent's runtime environment, including network access policies and repository-specific tooling.

### Configure internet access

To configure which external domains agents can reach during agent execution, navigate to **Bits AI Dev** > [**Settings**][12] > **General**, and find the **Internet Access** section. Choose from the following access policies: **No Internet Access**, **Default Allowlist**, **Custom + Default Allowlist**, or **Custom Allowlist**.
By default, the Dev Agent has **no internet access** during agent execution. To configure which external domains agents can reach, navigate to **Bits AI Dev** > [**Settings**][12] > **General**, and find the **Internet Access** section. Choose from the following access policies: **No Internet Access**, **Default Allowlist**, **Custom + Default Allowlist**, or **Custom Allowlist**.

The default allowlist includes the following domains:

| Language | Domains |
|---|---|
| Clojure/JVM | `repo.clojars.org` |
| Go | `pkg.go.dev`, `proxy.golang.org`, `vuln.go.dev` |
| Go | `pkg.go.dev`, `proxy.golang.org`, `sum.golang.org`, `vuln.go.dev` |
| Java/JVM | `repo1.maven.org` |
| JavaScript/TypeScript | `registry.npmjs.org` |
| JavaScript/TypeScript | `registry.npmjs.org`, `registry.yarnpkg.com` |
| .NET/C# | `api.nuget.org` |
| PHP | `packagist.org`, `repo.packagist.org` |
| Python | `files.pythonhosted.org`, `pypi.org`, `pypi.python.org`, `pythonhosted.org` |
| Rust | `index.crates.io`, `static.crates.io` |

### Configure custom instructions

The Dev Agent ingests custom instruction files from your repository, including:

- `.cursorrules`
- `.windsurfrules`
- `copilot-instructions.md`
- `CLAUDE.md`
- `AGENTS.md`
- `agent.md`


You can also define global custom instructions, which apply to all Dev Agent sessions, in **Bits AI Dev** > [**Settings**][12] > **General**, in the **Global Agent Instructions** section.

### Configure repository environment

Configure a custom environment for the Dev Agent to install dependencies, formatters, linters, and build tools that are needed for your codebase. Each repository runs in its own isolated sandbox, and the environment defines the settings for that sandbox.
Expand Down
Loading