prime-agent.nix options

prime-agent.package

The Prime Agent package to install.

Type: package

Default:

<derivation prime-agent-0.7.0>

prime-agent.environment

Environment exported before Prime Agent starts. This may be a shell environment file, or an attribute set of explicit { value = ...; } and { file = ...; } entries. File entries are read at runtime so they work with secret managers such as sops-nix.

Type: null or shell environment file or attribute set with POSIX environment variable names

Default:

null

Example:

{
  PRIME_AGENT_CODING_AGENT_DIR.value = "/home/user/.prime/agent";
  OPENAI_API_KEY.file = config.sops.secrets.openai-api-key.path;
}

prime-agent.environment.<name>.file

File whose contents are exported at runtime.

Type: string or absolute path

Declared by: - /nix/store/caiyazslrls8pmba985d1rgsgd7c84s9-source/modules/options.nix

prime-agent.environment.<name>.value

Literal value to export.

Type: string

Declared by: - /nix/store/caiyazslrls8pmba985d1rgsgd7c84s9-source/modules/options.nix

prime-agent.environment.PRIME_AGENT_CODING_AGENT_DIR

Prime Agent’s user configuration directory.

Type: null or (attribute set containing exactly one of `file` or `value`)

Default:

null

Example:

{ value = "${config.home.homeDirectory}/.prime/agent"; }

prime-agent.environment.PRIME_AGENT_CODING_AGENT_DIR.file

File whose contents are exported at runtime.

Type: string or absolute path

Declared by: - /nix/store/caiyazslrls8pmba985d1rgsgd7c84s9-source/modules/options.nix

prime-agent.environment.PRIME_AGENT_CODING_AGENT_DIR.value

Literal value to export.

Type: string

Declared by: - /nix/store/caiyazslrls8pmba985d1rgsgd7c84s9-source/modules/options.nix

prime-agent.extensions

Extension sources passed through repeated --extension flags.

Type: list of (absolute path or string)

Default:

[ ]

prime-agent.extraArgs

Raw CLI arguments prepended when launching an agent.

Type: list of string

Default:

[ ]

Example:

[ "--provider" "openai" "--model" "gpt-5" ]

prime-agent.jail.enable

Whether to enable bubblewrap isolation for Prime Agent using jail.nix.

Type: boolean

Default:

false

Example:

true

prime-agent.jail.permissions

Permissions passed to jail.nix. The default permits model and kernel downloads and mounts the invocation’s working directory read-write.

Prime Agent’s user configuration and default IPython kernel state are mounted separately and need not be listed here. Daemon socket state is retained between invocations, and files referenced by environment.*.file are exposed read-only automatically. The jail is available only on Linux.

Type: function that evaluates to a(n) list of raw value

Default:

combinators: with combinators; [
  network
  mount-cwd
]

Example:

combinators: with combinators; [
  network
  mount-cwd
  (add-pkg-deps [ pkgs.gnumake pkgs.python3 ])
  (try-readonly (noescape "~/.gitconfig"))
]

prime-agent.models

Path to a models.json file installed into Prime Agent’s configuration directory and kept in sync before each invocation. The default directory is ~/.prime/agent and can be changed with environment.PRIME_AGENT_CODING_AGENT_DIR.

Type: null or absolute path

Default:

null

Example:

./models.json

prime-agent.promptTemplates

Prompt template paths passed through repeated --prompt-template flags.

Type: list of absolute path

Default:

[ ]

prime-agent.rules

Instructions appended to Prime Agent’s system prompt.

Type: null or strings concatenated with “\n” or absolute path

Default:

null

Example:

./AGENTS.md

prime-agent.settings

Values merged into the global settings.json before each invocation.

Type: attribute set

Default:

{ }

prime-agent.skills

Skill paths passed through repeated --skill flags.

Type: list of absolute path

Default:

[ ]

prime-agent.themes

Theme paths passed through repeated --theme flags.

Type: list of absolute path

Default:

[ ]