Configuration

Pike LSP can be configured through VS Code settings to customize its behavior for your workflow.

VS Code Settings

Open VS Code settings (Ctrl+,) and search for "Pike" to find all available options.

Core Settings

Setting	Type	Default	Description
pike.pikePath	string	"pike"	Path to the Pike executable
pike.trace.server	string	"off"	LSP trace level: "off", "messages", or "verbose"
pike.enable	boolean	true	Enable/disable the LSP server

Formatting Profiles

Pike LSP supports configurable formatting profiles to match your coding style preferences:

Profile	Description
pike.formatting.profile	Select a predefined profile: compact, standard, relaxed, allman, or custom
pike.formatting.maxLineLength	Maximum line length: 0 (disabled), 80, 100, or 120
pike.formatting.braceStyle	Brace placement: same-line (K&R) or new-line (Allman)
pike.formatting.spaceAroundOperators	Insert spaces around operators (e.g., a + b vs a+b)
pike.formatting.blankLinesBetweenFunctions	Number of blank lines between top-level functions

Predefined Profiles

Profile	Line Length	Brace Style	Operators	Description
compact	80 chars	K&R	Spaced	Compact style for smaller screens
standard	100 chars	K&R	Spaced	Balanced default profile
relaxed	120 chars	K&R	Spaced	Relaxed style for wide displays
allman	100 chars	Allman	Spaced	Allman brace style
custom	User-defined	User-defined	User-defined	Use individual settings

Example Configuration

{
  "pike.pikePath": "/usr/local/bin/pike",
  "pike.trace.server": "off",
  "pike.formatting.profile": "standard",
  "pike.formatting.maxLineLength": 100,
  "pike.formatting.braceStyle": "same-line",
  "pike.formatting.spaceAroundOperators": true,
  "pike.formatting.blankLinesBetweenFunctions": 1
}

K&R vs Allman Brace Style

K&R Style (same-line):

void foo() {
    if (x > 0) {
        return x;
    }
}

Allman Style (new-line):

void foo()
{
    if (x > 0)
    {
        return x;
    }
}

File Associations

By default, Pike LSP activates for .pike and .pmod files. To enable it for additional file types:

{
  "files.associations": {
    "*.rjs": "pike",
    "*.inc": "pike",
    "*.pike.in": "pike"
  }
}

Environment Variables

Pike LSP respects the following environment variables:

Variable	Description
PIKE_PATH	Pike module search path
PIKE_INCLUDE_PATH	Pike include path
PIKE_MODULE_PATH	Pike module path
PIKE_SRC	Pike source directory (for development)
ROXEN_SRC	Roxen source directory (for development)

Pike Path Resolution

Pike LSP uses the following order to find the Pike executable:

1. pike.pikePath setting (if configured)
2. PIKE_PATH environment variable
3. System PATH

Troubleshooting Configuration

Verify Pike Path

which pike
# or
whereis pike

Test Pike Execution

pike --version

Enable Verbose Logging

For debugging issues:

{
  "pike.trace.server": "verbose"
}

View logs in VS Code: Output panel → Select "Pike Language Server" from dropdown

Workspace-Specific Configuration

You can configure Pike LSP per workspace by creating .vscode/settings.json:

{
  "pike.pikePath": "/path/to/project-specific/pike",
  "files.associations": {
    "*.module": "pike"
  }
}

Roxen Configuration

For Roxen module development, additional settings may be needed:

{
  "pike.roxenPath": "/path/to/roxen",
  "files.associations": {
    "*.rjs": "pike"
  }
}

Keyboard Shortcuts

Default VS Code shortcuts for LSP features:

Feature	Shortcut
Go to Definition	F12
Find References	Shift+F12
Rename Symbol	F2
Trigger Completion	Ctrl+Space
Signature Help	Ctrl+Shift+Space
Go to Symbol	Ctrl+Shift+O
Workspace Symbol	Ctrl+T
Show Hover	Ctrl+K Ctrl+I
Code Actions	Ctrl+.
Format Document	Shift+Alt+F

You can customize these in VS Code Keyboard Shortcuts settings.

Related Topics

• Getting Started - Installation guide
• Troubleshooting - Common issues and solutions
• Features - Complete feature list