Struct ProjectEntry 

struct ProjectEntry {
    name: String,
    path: String,
    model: Option<String>,
    permission_mode: Option<String>,
    max_workers: Option<usize>,
    env: HashMap<String, String>,
    env_file: Option<String>,
    document_roots: Vec<String>,
    handoff: Option<HandoffSettings>,
    browser_profile: Option<String>,
    slack: Option<SlackBinding>,
}

Fields

name: String

path: String

model: Option<String>

The project’s model: fills the CLI’s model slots at spawn (ANTHROPIC_DEFAULT_*_MODEL, ANTHROPIC_SMALL_FAST_MODEL, CLAUDE_CODE_SUBAGENT_MODEL). Required to be declared by at least one account in the org.

permission_mode: Option<String>

CLI permission mode stamped onto every session this project spawns. Absent resolves to auto.

max_workers: Option<usize>

Cap on this project’s concurrently live dynamic workers. Absent keeps the default.

env: HashMap<String, String>

Per-project environment entries, layered over the account’s env at spawn.

env_file: Option<String>

Path to a KEY=value file whose entries join this project’s env, so a secret can live outside forge.toml. Read once at load, like every other value here, so rotating it needs a forge restart.

document_roots: Vec<String>

Extra roots the document read accepts beyond the session’s own tree, so a project’s documents can live outside its repo (a vault, a shared spec directory). Each entry is absolute or starts with ~; a relative one is a load error. Absent -> empty.

handoff: Option<HandoffSettings>

This project’s handoff trigger, layered over the top-level table. Every key is optional, so a project sets the one it disagrees on.

browser_profile: Option<String>

This project’s browser profile name; <org>/<name>. Absent keeps the org’s.

slack: Option<SlackBinding>

This project’s Slack workspace, overriding the org’s. Absent keeps the org’s binding.

Implementations

impl ProjectEntry

fn permission_mode( &self, path: &Path, name: &str, ) -> Result<PermissionMode, WorkspaceError>

The resolved mode for the project. Absent is auto, not “no override”: under account rotation a session can start on any account in its org’s pool, so the project is the stable scope and a forge default is what keeps its sessions consistent.

Trait Implementations

impl Debug for ProjectEntry

Hand-written because a project’s env may carry secrets, which the derived output would print.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProjectEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.