Struct IngestArgs 

pub struct IngestArgs {

    pub dir: PathBuf,
    pub type: MemoryType,
    pub pattern: String,
    pub recursive: bool,
    pub enable_ner: bool,
    pub gliner_variant: String,
    pub skip_extraction: bool,
    pub fail_fast: bool,
    pub dry_run: bool,
    pub max_files: usize,
    pub namespace: Option<String>,
    pub db: Option<String>,
    pub format: JsonOutputFormat,
    pub json: bool,
    pub ingest_parallelism: Option<usize>,
    pub low_memory: bool,
    pub max_rss_mb: u64,
    pub max_name_length: usize,
    pub mode: IngestMode,
    pub claude_binary: Option<PathBuf>,
    pub claude_model: Option<String>,
    pub resume: bool,
    pub retry_failed: bool,
    pub keep_queue: bool,
    pub queue_db: String,
    pub rate_limit_wait: u64,
    pub max_cost_usd: Option<f64>,
}

Fields

dir: PathBuf

Directory containing files to ingest.

type: MemoryType

Memory type stored in memories.type for every ingested file. Defaults to document.

pattern: String

Glob pattern matched against file basenames (default: *.md). Supports *.<ext>, <prefix>*, and exact filename match.

recursive: bool

Recurse into subdirectories.

enable_ner: bool

gliner_variant: String

skip_extraction: bool

Deprecated: NER is now disabled by default. Kept for backwards compatibility.

fail_fast: bool

Stop on first per-file error instead of continuing with the next file.

dry_run: bool

Preview file-to-name mapping without loading model or persisting.

max_files: usize

Maximum number of files to ingest (safety cap to prevent runaway ingestion).

namespace: Option<String>

Namespace for the ingested memories.

db: Option<String>

Database path. Falls back to SQLITE_GRAPHRAG_DB_PATH, then ./graphrag.sqlite.

format: JsonOutputFormat

json: bool

ingest_parallelism: Option<usize>

Number of files to extract+embed in parallel; default = max(1, cpus/2).min(4).

low_memory: bool

Force single-threaded ingest to reduce RSS pressure.

Equivalent to --ingest-parallelism 1, takes precedence over any explicit value. Recommended for environments with <4 GB available RAM or container/cgroup constraints. Trade-off: 3-4x longer wall time. Also honored via SQLITE_GRAPHRAG_LOW_MEMORY=1 env var (CLI flag has higher precedence than the env var).

max_rss_mb: u64

Maximum process RSS in MiB; abort if exceeded during embedding.

max_name_length: usize

Maximum character length for derived memory names from file basenames.

Overrides the compile-time DERIVED_NAME_MAX_LEN constant (default 60). Shorter values leave more headroom for collision suffix resolution.

mode: IngestMode

Extraction mode: none (body-only, default), gliner (NER), or claude-code (LLM-curated via Claude Code CLI).

claude_binary: Option<PathBuf>

Explicit path to the Claude Code binary (only with –mode claude-code).

claude_model: Option<String>

Model override for Claude Code extraction (e.g. claude-sonnet-4-6).

resume: bool

Resume a previously interrupted claude-code ingest from the queue DB.

retry_failed: bool

Retry only failed files from a previous claude-code ingest.

keep_queue: bool

Keep the queue DB (.ingest-queue.sqlite) after completion.

queue_db: String

Custom path for the claude-code ingest queue database.

rate_limit_wait: u64

Initial wait time in seconds when rate-limited (only with –mode claude-code).

max_cost_usd: Option<f64>

Maximum cumulative cost in USD before aborting (only with –mode claude-code).

Trait Implementations

impl Args for IngestArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl FromArgMatches for IngestArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.