diff --git a/docs/cli/configuration.mdx b/docs/cli/configuration.mdx
index 851dec6bab4..6fa8fb321db 100644
--- a/docs/cli/configuration.mdx
+++ b/docs/cli/configuration.mdx
@@ -75,3 +75,16 @@ Store sensitive values (API keys, tokens) in [Continue → Settings → Secrets]
 ```yaml
 ${{ secrets.MY_API_KEY }}
 ```
+
+## Advanced environment flags
+
+### `CONTINUE_USE_AI_SDK`
+
+Set `CONTINUE_USE_AI_SDK=1` to route `openai` and `anthropic` provider requests through Continue's Vercel AI SDK adapter instead of the default provider clients:
+
+```bash
+export CONTINUE_USE_AI_SDK=1
+cn
+```
+
+This is useful when you want to test the AI SDK-backed request path without changing your `config.yaml`. The flag only changes `openai` and `anthropic` providers; all other providers continue using their standard adapters.
diff --git a/docs/cli/headless-mode.mdx b/docs/cli/headless-mode.mdx
index f493869ff6f..bdc8fc46214 100644
--- a/docs/cli/headless-mode.mdx
+++ b/docs/cli/headless-mode.mdx
@@ -48,6 +48,12 @@ cn -p "Set up the project" --allow "*"
 
 See [tool permissions](/cli/tool-permissions) for the full policy system.
 
+Read-only helpers such as `CheckBackgroundJob` remain allowed by default, so the agent can safely inspect long-running work without additional approval.
+
+## Background jobs
+
+If a shell command is moved to the background, Continue returns a job id and the output collected so far. The agent can then call `CheckBackgroundJob("<job-id>")` to fetch the current status, exit code, and accumulated output while the job continues running.
+
 ## Authentication in CI
 
 Set `CONTINUE_API_KEY` instead of running `cn login`: