Workspace Settings

Accessing Settings

Open workspace settings:

Via Menu
Via Keyboard

macOS: Cmd + ,
Windows/Linux: Ctrl + ,

General Settings

Basic Information

string

required

Workspace display name

{
  "name": "ACME Corp APIs"
}

string

Optional workspace description

{
  "description": "API collections for ACME Corporation projects"
}

path

required

Local file system path

{
  "location": "~/Documents/Auk/acme-corp"
}

Default Environment

string

Environment to load on workspace startup

{
  "defaultEnvironment": "development"
}

Options:

null - No default environment
"development" - Development environment
"staging" - Staging environment
"production" - Production environment
Any custom environment name

Git Sync Settings

Repository Configuration

boolean

default:"false"

Enable Git synchronization

{
  "git": {
    "enabled": true
  }
}

string

Remote repository URL

{
  "git": {
    "remoteUrl": "[email protected]:acme/api-collections.git"
  }
}

string

default:"main"

Default branch for synchronization

{
  "git": {
    "branch": "main"
  }
}

Sync Behavior

boolean

default:"false"

Enable automatic synchronization

{
  "git": {
    "autoSync": true
  }
}

number

default:"900"

Auto-sync interval in seconds

{
  "git": {
    "syncInterval": 900
  }
}

Common values:

300 - 5 minutes (active collaboration)
900 - 15 minutes (default)
3600 - 1 hour (less frequent)

boolean

default:"true"

Sync before switching workspaces

{
  "git": {
    "syncBeforeSwitch": true
  }
}

Conflict Resolution

string

default:"prompt"

How to handle merge conflicts

{
  "git": {
    "conflictResolution": "prompt"
  }
}

Options:

"prompt" - Ask user for each conflict (default)
"keepLocal" - Always keep local changes
"useRemote" - Always use remote changes
"smartMerge" - Attempt automatic merge

Commit Settings

boolean

default:"true"

Automatically commit changes

{
  "git": {
    "autoCommit": true
  }
}

string

Template for commit messages

{
  "git": {
    "commitMessageTemplate": "Update {{collection}} - {{timestamp}}"
  }
}

Available variables:

{{collection}} - Collection name
{{timestamp}} - Current timestamp
{{user}} - Git user name

Network Settings

Proxy Configuration

boolean

default:"false"

Enable HTTP/HTTPS proxy

{
  "proxy": {
    "enabled": true
  }
}

string

Proxy server URL

{
  "proxy": {
    "url": "http://proxy.company.com:8080"
  }
}

object

Proxy authentication credentials

{
  "proxy": {
    "auth": {
      "username": "user",
      "password": "pass"
    }
  }
}

array

Domains to bypass proxy

{
  "proxy": {
    "bypass": ["localhost", "127.0.0.1", "*.internal.com"]
  }
}

Interceptor

string

default:"none"

Request interceptor mode

{
  "interceptor": {
    "mode": "proxy"
  }
}

Options:

"none" - Direct requests (default)
"proxy" - Use Auk Agent or configured proxy
"proxy" - System proxy

Request Settings

Timeout

number

default:"30000"

Request timeout in milliseconds

{
  "request": {
    "timeout": 30000
  }
}

SSL/TLS

boolean

default:"true"

Validate SSL certificates

{
  "request": {
    "validateSSL": true
  }
}

Disabling SSL validation is insecure. Only use for development with self-signed certificates.

object

Client certificate for mutual TLS

{
  "request": {
    "clientCertificate": {
      "cert": "/path/to/cert.pem",
      "key": "/path/to/key.pem",
      "passphrase": "optional-passphrase"
    }
  }
}

Headers

array

Default headers for all requests

{
  "request": {
    "defaultHeaders": [
      {
        "key": "User-Agent",
        "value": "Auk/3.0"
      }
    ]
  }
}

UI Settings

Theme

string

default:"system"

Application theme

{
  "ui": {
    "theme": "dark"
  }
}

Options:

"system" - Follow system theme
"light" - Light theme
"dark" - Dark theme

Font

number

default:"14"

Base font size in pixels

{
  "ui": {
    "fontSize": 14
  }
}

string

Font family for code editor

{
  "ui": {
    "fontFamily": "JetBrains Mono, monospace"
  }
}

History Settings

boolean

default:"true"

Enable request history

{
  "history": {
    "enabled": true
  }
}

number

default:"1000"

Maximum history entries to keep

{
  "history": {
    "maxEntries": 1000
  }
}

number

default:"30"

Days to retain history

{
  "history": {
    "retentionDays": 30
  }
}

Example Configurations

Minimal Configuration

{
  "name": "Personal APIs",
  "location": "~/Documents/Auk/personal",
  "defaultEnvironment": "development"
}

Team Workspace with Git

{
  "name": "ACME Corp APIs",
  "location": "~/Documents/Auk/acme-corp",
  "defaultEnvironment": "development",
  "git": {
    "enabled": true,
    "remoteUrl": "[email protected]:acme/api-collections.git",
    "branch": "main",
    "autoSync": true,
    "syncInterval": 900,
    "conflictResolution": "prompt"
  }
}

Corporate Environment with Proxy

{
  "name": "Corporate APIs",
  "location": "~/Documents/Auk/corporate",
  "proxy": {
    "enabled": true,
    "url": "http://proxy.company.com:8080",
    "auth": {
      "username": "user",
      "password": "pass"
    },
    "bypass": ["localhost", "*.internal.com"]
  },
  "request": {
    "validateSSL": false,
    "clientCertificate": {
      "cert": "/path/to/cert.pem",
      "key": "/path/to/key.pem"
    }
  }
}

Next Steps

Git Sync Setup

Configure Git synchronization

Environments

Manage environment variables

Proxy & Interceptor

Configure network settings

Keyboard Shortcuts

Customize keyboard shortcuts

Getting Started

Core Concepts

Workspace Management

Git Sync

API Testing

Features

Data Management

Desktop Client

Accessing Settings

General Settings

Basic Information

Default Environment

Git Sync Settings

Repository Configuration

Sync Behavior

Conflict Resolution

Commit Settings

Network Settings

Proxy Configuration

Interceptor

Request Settings

Timeout

SSL/TLS

Headers

UI Settings

Theme

Font

History Settings

Example Configurations

Minimal Configuration

Team Workspace with Git

Corporate Environment with Proxy

Next Steps

Git Sync Setup

Environments

Proxy & Interceptor

Keyboard Shortcuts

​Accessing Settings

​General Settings

​Basic Information

​Default Environment

​Git Sync Settings

​Repository Configuration

​Sync Behavior

​Conflict Resolution

​Commit Settings

​Network Settings

​Proxy Configuration

​Interceptor

​Request Settings

​Timeout

​SSL/TLS

​Headers

​UI Settings

​Theme

​Font

​History Settings

​Example Configurations

​Minimal Configuration

​Team Workspace with Git

​Corporate Environment with Proxy

​Next Steps

Git Sync Setup

Environments

Proxy & Interceptor

Keyboard Shortcuts

Accessing Settings

General Settings

Basic Information

Default Environment

Git Sync Settings

Repository Configuration

Sync Behavior

Conflict Resolution

Commit Settings

Network Settings

Proxy Configuration

Interceptor

Request Settings

Timeout

SSL/TLS

Headers

UI Settings

Theme

Font

History Settings

Example Configurations

Minimal Configuration

Team Workspace with Git

Corporate Environment with Proxy

Next Steps