Skip to main content

Headless Mode

"Headless mode" allows Continue to run in the background, without needing to be connected to the IDE or GUI. This is useful for performing refactors or other long-running tasks asynchronously. Headless mode can also be run in CI/CD for example to perform a thorough review for errors.

To use headless mode:

  1. pip install continuedev (using a virtual environment is recommended)
  2. Import continuedev and call run with the Step you would like to run


Say you have the following file (/path/to/

def say_hello(name: str):
print(f"Hello, {name}")

and this function is imported and used in multiple places throughout your codebase. But the name parameter is new, and you need to change the function call everywhere it is used. You can use the script below to edit all usages of the function in your codebase:

from continuedev import run
from continuedev.models.main import Position, PositionInFile
from continuedev.plugins.steps.refactor import RefactorReferencesStep

step = RefactorReferencesStep(
position=Position(line=0, character=5),

Here we use Continue's built-in RefactorReferencesStep. By passing it the location (filepath and position) of the symbol (function, variable, etc.) that we want to update, Continue will automatically find all references to that symbol and prompt an LLM to make the edit requested in the user_input field.