Cline rules

1# Networking & Proxy Support
2 
3To ensure Cline works correctly in all environments (VSCode, JetBrains, CLI) and with various network configurations (especially corporate proxies), strictly follow these guidelines for all network activity.
4 
5In extension code, do NOT use the global `fetch` or a default `axios` instance. (Note, `shared/net.ts` is exempt from these rules because it sets up the fetch wrappers.) In Webview code, you SHOULD use global `fetch`.
6 
7Global `fetch` and default `axios` do not automatically pick up proxy configurations in all environments (specifically JetBrains and CLI). You MUST use the provided utilities in `@/shared/net` which handle proxy agent configuration. In the webview, the browser/embedder handles proxies.
8 
9## Guidelines
10 
11### 1. Using `fetch`
12 
13Instead of `fetch(...)`, import the proxy-aware wrapper:
14 
15```typescript
16import { fetch } from '@/shared/net'
17 
18// Usage is identical to global fetch
19const response = await fetch('https://api.example.com/data')
20```
21 
22### 2. Using `axios`
23 
24When using `axios`, you must apply the settings from `getAxiosSettings()`:
25 
26```typescript
27import axios from 'axios'
28import { getAxiosSettings } from '@/shared/net'
29 
30const response = await axios.get('https://api.example.com/data', {
31  headers: { 'Authorization': '...' },
32  ...getAxiosSettings() // <--- CRITICAL: Injects the proxy agent if needed
33})
34```
35 
36### 3. Third-Party Clients (OpenAI, Ollama, etc.)
37 
38Most API client libraries allow you to customize the `fetch` implementation. You **MUST** pass the proxy-aware `fetch` to these clients.
39 
40**Example (OpenAI):**
41```typescript
42import OpenAI from "openai"
43import { fetch } from "@/shared/net"
44 
45this.client = new OpenAI({
46  apiKey: '...',
47  fetch, // <--- CRITICAL: Pass our fetch wrapper
48})
49```
50 
51### 4. Tests
52 
53Use `mockFetchForTesting` to mock the underlying fetch implementation.
54 
55**Example (callback):**
56 
57```
58import { mockFetchForTesting } from "@/shared/net"
59 
60...
61  let mockFetch = ...
62  mockFetchForTesting(mockFetch, () => {
63    // This calls mockFetch
64    fetch('https://foo.example').then(...)
65  })
66  // Original fetch is restored immediately when the call returns.
67```
68 
69**Example (Promise):**
70 
71```
72import { mockFetchForTesting } from "@/shared/net"
73 
74...
75  let mockFetch = ...
76  await mockFetchForTesting(mockFetch, async () => {
77    await ...
78    // This calls mockFetch
79    await fetch('https://foo.example')
80    ...
81  })
82  // Original fetch is restored when the Promise from the callback settles
83```
84 
85## Verification
86 
87If you are adding a new network call or integration:
881.  Check `@/shared/net.ts` is imported.
892.  Ensure `fetch` or `getAxiosSettings` is being used.
903.  Verify that third-party clients are configured to use the custom fetch.
91