agent-cli 0.90.0__tar.gz → 0.92.0__tar.gz

{agent_cli-0.90.0 → agent_cli-0.92.0}/.pre-commit-config.yaml

@@ -11,13 +11,13 @@ repos:
       - id: end-of-file-fixer
       - id: mixed-line-ending
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.15.11"
+    rev: "v0.15.12"
     hooks:
       - id: ruff
         args: ["--fix"]
       - id: ruff-format
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: "v1.20.1"
+    rev: "v1.20.2"
     hooks:
       - id: mypy
         additional_dependencies: ["types-PyYAML"]

{agent_cli-0.90.0 → agent_cli-0.92.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.90.0
+Version: 0.92.0
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>
@@ -263,6 +263,7 @@ The setup scripts automatically install:
   - [Installation Commands](#installation-commands)
     - [Installing Optional Extras](#installing-optional-extras)
   - [Configuration](#configuration)
+    - [Environment variable overrides](#environment-variable-overrides)
     - [Managing Configuration](#managing-configuration)
     - [Provider Defaults](#provider-defaults)
   - [`autocorrect`](#autocorrect)
@@ -571,15 +572,36 @@ agent-cli install-extras rag memory vad
 
 ### Configuration
 
-All `agent-cli` commands can be configured using a TOML file. The configuration file is searched for in the following locations, in order:
+All `agent-cli` commands can be configured using a TOML file.
+The configuration file is searched for in the following locations, in order:
 
-1.  `./agent-cli-config.toml` (in the current directory)
-2.  `~/.config/agent-cli/config.toml`
+1.  CLI flag (`--config` on agent commands, `--path` on `agent-cli config ...`)
+2.  `$AGENT_CLI_CONFIG_HOME/config.toml` if set
+3.  `./agent-cli-config.toml` (in the current directory)
+4.  `$XDG_CONFIG_HOME/agent-cli/config.toml` if `XDG_CONFIG_HOME` is set and non-empty, otherwise `~/.config/agent-cli/config.toml`
 
 You can also specify a path to a configuration file using the `--config` option, e.g., `agent-cli transcribe --config /path/to/your/config.toml`.
 
 Command-line options always take precedence over settings in the configuration file.
 
+#### Environment variable overrides
+
+Use `AGENT_CLI_CONFIG_HOME` to redirect the user-level config to a directory of your choice:
+
+```bash
+# use a project-scoped config
+AGENT_CLI_CONFIG_HOME=./.agent-cli agent-cli chat ...
+```
+
+Use `XDG_CONFIG_HOME` to follow XDG-style config placement when no `AGENT_CLI_CONFIG_HOME` is set:
+
+```bash
+# follow XDG (e.g. inside a sandbox or container)
+XDG_CONFIG_HOME=/workspace/.config agent-cli chat ...
+```
+
+Config paths are resolved when `agent-cli` starts, so set these variables before invoking the command.
+
 #### Managing Configuration
 
 Use the `config` command to manage your configuration files:
@@ -620,11 +642,20 @@ agent-cli config edit
 
  Config files are TOML format and searched in order:
 
-  1 ./agent-cli-config.toml (project-local)
-  2 ~/.config/agent-cli/config.toml (user default)
+  1 $AGENT_CLI_CONFIG_HOME/config.toml (if set)
+  2 ./agent-cli-config.toml (project-local)
+  3 $XDG_CONFIG_HOME/agent-cli/config.toml (if set)
+  4 ~/.config/agent-cli/config.toml (user default)
+
+ Settings in [defaults] apply globally.
+
+ Use [chat] or [transcribe] for command-specific overrides.
+
+ CLI arguments override config file settings.
+
+ Set env vars before startup.
 
- Settings in [defaults] apply to all commands. Override per-command with sections like
- [chat] or [transcribe]. CLI arguments override config file settings.
+ Use $AGENT_CLI_CONFIG_HOME or $XDG_CONFIG_HOME to change config path.
 
 ╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
 │ --help  -h        Show this message and exit.                                          │
@@ -829,6 +860,8 @@ the `[defaults]` section of your configuration file.
   • Record and transcribe: agent-cli transcribe
   • With LLM cleanup: agent-cli transcribe --llm
   • Re-transcribe last recording: agent-cli transcribe --last-recording 1
+  • Remember unknown voices: agent-cli transcribe --diarize --remember-unknown-speakers
+  • Name a remembered voice profile: agent-cli speakers rename UNKNOWN_001 Alice
 
 ╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
 │ --help  -h        Show this message and exit.                                          │
@@ -962,42 +995,95 @@ the `[defaults]` section of your configuration file.
 │                                                                  LLM cleanup.          │
 ╰────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Diarization ──────────────────────────────────────────────────────────────────────────╮
-│ --diarize           --no-diarize                       Enable speaker diarization      │
-│                                                        (requires pyannote-audio).      │
-│                                                        Install with: pip install       │
-│                                                        agent-cli[diarization]          │
-│                                                        [default: no-diarize]           │
-│ --diarize-format                        [inline|json]  Output format for diarization   │
-│                                                        ('inline' for [Speaker N]:      │
-│                                                        text, 'json' for structured     │
-│                                                        output).                        │
-│                                                        [default: inline]               │
-│ --hf-token                              TEXT           HuggingFace token for pyannote  │
-│                                                        models. Required for            │
-│                                                        diarization. Token must have    │
-│                                                        'Read access to contents of all │
-│                                                        public gated repos you can      │
-│                                                        access' permission. Accept      │
-│                                                        licenses at:                    │
-│                                                        https://hf.co/pyannote/speaker… │
-│                                                        https://hf.co/pyannote/segment… │
-│                                                        https://hf.co/pyannote/wespeak… │
-│                                                        [env var: HF_TOKEN]             │
-│ --min-speakers                          INTEGER        Minimum number of speakers      │
-│                                                        (optional hint for              │
-│                                                        diarization).                   │
-│ --max-speakers                          INTEGER        Maximum number of speakers      │
-│                                                        (optional hint for              │
-│                                                        diarization).                   │
-│ --align-words       --no-align-words                   Use wav2vec2 forced alignment   │
-│                                                        for word-level speaker          │
-│                                                        assignment (more accurate but   │
-│                                                        slower).                        │
-│                                                        [default: no-align-words]       │
-│ --align-language                        TEXT           Language code for word          │
-│                                                        alignment model (e.g., 'en',    │
-│                                                        'fr', 'de', 'es', 'it').        │
-│                                                        [default: en]                   │
+│ --diarize               --no-diarize                               Enable speaker      │
+│                                                                    diarization         │
+│                                                                    (requires           │
+│                                                                    pyannote-audio).    │
+│                                                                    Install with: pip   │
+│                                                                    install             │
+│                                                                    agent-cli[diarizat… │
+│                                                                    [default:           │
+│                                                                    no-diarize]         │
+│ --diarize-format                              [inline|json]        Output format for   │
+│                                                                    diarization         │
+│                                                                    ('inline' for       │
+│                                                                    [Speaker N]: text,  │
+│                                                                    'json' for          │
+│                                                                    structured output). │
+│                                                                    [default: inline]   │
+│ --hf-token                                    TEXT                 HuggingFace token   │
+│                                                                    for pyannote        │
+│                                                                    models. Required    │
+│                                                                    for diarization.    │
+│                                                                    Token must have     │
+│                                                                    'Read access to     │
+│                                                                    contents of all     │
+│                                                                    public gated repos  │
+│                                                                    you can access'     │
+│                                                                    permission. Accept  │
+│                                                                    licenses at:        │
+│                                                                    https://hf.co/pyan… │
+│                                                                    https://hf.co/pyan… │
+│                                                                    https://hf.co/pyan… │
+│                                                                    [env var: HF_TOKEN] │
+│ --min-speakers                                INTEGER              Minimum number of   │
+│                                                                    speakers (optional  │
+│                                                                    hint for            │
+│                                                                    diarization).       │
+│ --max-speakers                                INTEGER              Maximum number of   │
+│                                                                    speakers (optional  │
+│                                                                    hint for            │
+│                                                                    diarization).       │
+│ --align-words           --no-align-words                           Use wav2vec2 forced │
+│                                                                    alignment for       │
+│                                                                    word-level speaker  │
+│                                                                    assignment (more    │
+│                                                                    accurate but        │
+│                                                                    slower).            │
+│                                                                    [default:           │
+│                                                                    no-align-words]     │
+│ --align-language                              TEXT                 Language code for   │
+│                                                                    word alignment      │
+│                                                                    model (e.g., 'en',  │
+│                                                                    'fr', 'de', 'es',   │
+│                                                                    'it').              │
+│                                                                    [default: en]       │
+│ --enroll-speakers                             TEXT                 Enroll current      │
+│                                                                    speaker labels or   │
+│                                                                    remembered profile  │
+│                                                                    IDs into persistent │
+│                                                                    voice profiles,     │
+│                                                                    e.g.                │
+│                                                                    SPEAKER_00=Alice or │
+│                                                                    UNKNOWN_001=Alice.  │
+│                                                                    For simple renames, │
+│                                                                    use agent-cli       │
+│                                                                    speakers rename.    │
+│ --identify-speakers     --no-identify-spe…                         Match diarized      │
+│                                                                    speakers against    │
+│                                                                    persistent voice    │
+│                                                                    profiles when       │
+│                                                                    profiles exist.     │
+│                                                                    [default:           │
+│                                                                    identify-speakers]  │
+│ --remember-unknown-…    --no-remember-unk…                         Persist unmatched   │
+│                                                                    speaker embeddings  │
+│                                                                    as stable           │
+│                                                                    UNKNOWN_### voice   │
+│                                                                    profiles.           │
+│                                                                    [default:           │
+│                                                                    no-remember-unknow… │
+│ --speaker-profiles-…                          PATH                 JSON file storing   │
+│                                                                    persistent speaker  │
+│                                                                    voice embeddings.   │
+│                                                                    [default:           │
+│                                                                    /home/runner/.conf… │
+│ --speaker-match-thr…                          FLOAT RANGE          Cosine-similarity   │
+│                                               [0.0<=x<=1.0]        threshold for       │
+│                                                                    matching diarized   │
+│                                                                    speakers to stored  │
+│                                                                    profiles.           │
+│                                                                    [default: 0.7]      │
 ╰────────────────────────────────────────────────────────────────────────────────────────╯
 
 ```

{agent_cli-0.90.0 → agent_cli-0.92.0}/README.md

@@ -158,6 +158,7 @@ The setup scripts automatically install:
   - [Installation Commands](#installation-commands)
     - [Installing Optional Extras](#installing-optional-extras)
   - [Configuration](#configuration)
+    - [Environment variable overrides](#environment-variable-overrides)
     - [Managing Configuration](#managing-configuration)
     - [Provider Defaults](#provider-defaults)
   - [`autocorrect`](#autocorrect)
@@ -466,15 +467,36 @@ agent-cli install-extras rag memory vad
 
 ### Configuration
 
-All `agent-cli` commands can be configured using a TOML file. The configuration file is searched for in the following locations, in order:
+All `agent-cli` commands can be configured using a TOML file.
+The configuration file is searched for in the following locations, in order:
 
-1.  `./agent-cli-config.toml` (in the current directory)
-2.  `~/.config/agent-cli/config.toml`
+1.  CLI flag (`--config` on agent commands, `--path` on `agent-cli config ...`)
+2.  `$AGENT_CLI_CONFIG_HOME/config.toml` if set
+3.  `./agent-cli-config.toml` (in the current directory)
+4.  `$XDG_CONFIG_HOME/agent-cli/config.toml` if `XDG_CONFIG_HOME` is set and non-empty, otherwise `~/.config/agent-cli/config.toml`
 
 You can also specify a path to a configuration file using the `--config` option, e.g., `agent-cli transcribe --config /path/to/your/config.toml`.
 
 Command-line options always take precedence over settings in the configuration file.
 
+#### Environment variable overrides
+
+Use `AGENT_CLI_CONFIG_HOME` to redirect the user-level config to a directory of your choice:
+
+```bash
+# use a project-scoped config
+AGENT_CLI_CONFIG_HOME=./.agent-cli agent-cli chat ...
+```
+
+Use `XDG_CONFIG_HOME` to follow XDG-style config placement when no `AGENT_CLI_CONFIG_HOME` is set:
+
+```bash
+# follow XDG (e.g. inside a sandbox or container)
+XDG_CONFIG_HOME=/workspace/.config agent-cli chat ...
+```
+
+Config paths are resolved when `agent-cli` starts, so set these variables before invoking the command.
+
 #### Managing Configuration
 
 Use the `config` command to manage your configuration files:
@@ -515,11 +537,20 @@ agent-cli config edit
 
  Config files are TOML format and searched in order:
 
-  1 ./agent-cli-config.toml (project-local)
-  2 ~/.config/agent-cli/config.toml (user default)
+  1 $AGENT_CLI_CONFIG_HOME/config.toml (if set)
+  2 ./agent-cli-config.toml (project-local)
+  3 $XDG_CONFIG_HOME/agent-cli/config.toml (if set)
+  4 ~/.config/agent-cli/config.toml (user default)
+
+ Settings in [defaults] apply globally.
+
+ Use [chat] or [transcribe] for command-specific overrides.
+
+ CLI arguments override config file settings.
+
+ Set env vars before startup.
 
- Settings in [defaults] apply to all commands. Override per-command with sections like
- [chat] or [transcribe]. CLI arguments override config file settings.
+ Use $AGENT_CLI_CONFIG_HOME or $XDG_CONFIG_HOME to change config path.
 
 ╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
 │ --help  -h        Show this message and exit.                                          │
@@ -724,6 +755,8 @@ the `[defaults]` section of your configuration file.
   • Record and transcribe: agent-cli transcribe
   • With LLM cleanup: agent-cli transcribe --llm
   • Re-transcribe last recording: agent-cli transcribe --last-recording 1
+  • Remember unknown voices: agent-cli transcribe --diarize --remember-unknown-speakers
+  • Name a remembered voice profile: agent-cli speakers rename UNKNOWN_001 Alice
 
 ╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
 │ --help  -h        Show this message and exit.                                          │
@@ -857,42 +890,95 @@ the `[defaults]` section of your configuration file.
 │                                                                  LLM cleanup.          │
 ╰────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Diarization ──────────────────────────────────────────────────────────────────────────╮
-│ --diarize           --no-diarize                       Enable speaker diarization      │
-│                                                        (requires pyannote-audio).      │
-│                                                        Install with: pip install       │
-│                                                        agent-cli[diarization]          │
-│                                                        [default: no-diarize]           │
-│ --diarize-format                        [inline|json]  Output format for diarization   │
-│                                                        ('inline' for [Speaker N]:      │
-│                                                        text, 'json' for structured     │
-│                                                        output).                        │
-│                                                        [default: inline]               │
-│ --hf-token                              TEXT           HuggingFace token for pyannote  │
-│                                                        models. Required for            │
-│                                                        diarization. Token must have    │
-│                                                        'Read access to contents of all │
-│                                                        public gated repos you can      │
-│                                                        access' permission. Accept      │
-│                                                        licenses at:                    │
-│                                                        https://hf.co/pyannote/speaker… │
-│                                                        https://hf.co/pyannote/segment… │
-│                                                        https://hf.co/pyannote/wespeak… │
-│                                                        [env var: HF_TOKEN]             │
-│ --min-speakers                          INTEGER        Minimum number of speakers      │
-│                                                        (optional hint for              │
-│                                                        diarization).                   │
-│ --max-speakers                          INTEGER        Maximum number of speakers      │
-│                                                        (optional hint for              │
-│                                                        diarization).                   │
-│ --align-words       --no-align-words                   Use wav2vec2 forced alignment   │
-│                                                        for word-level speaker          │
-│                                                        assignment (more accurate but   │
-│                                                        slower).                        │
-│                                                        [default: no-align-words]       │
-│ --align-language                        TEXT           Language code for word          │
-│                                                        alignment model (e.g., 'en',    │
-│                                                        'fr', 'de', 'es', 'it').        │
-│                                                        [default: en]                   │
+│ --diarize               --no-diarize                               Enable speaker      │
+│                                                                    diarization         │
+│                                                                    (requires           │
+│                                                                    pyannote-audio).    │
+│                                                                    Install with: pip   │
+│                                                                    install             │
+│                                                                    agent-cli[diarizat… │
+│                                                                    [default:           │
+│                                                                    no-diarize]         │
+│ --diarize-format                              [inline|json]        Output format for   │
+│                                                                    diarization         │
+│                                                                    ('inline' for       │
+│                                                                    [Speaker N]: text,  │
+│                                                                    'json' for          │
+│                                                                    structured output). │
+│                                                                    [default: inline]   │
+│ --hf-token                                    TEXT                 HuggingFace token   │
+│                                                                    for pyannote        │
+│                                                                    models. Required    │
+│                                                                    for diarization.    │
+│                                                                    Token must have     │
+│                                                                    'Read access to     │
+│                                                                    contents of all     │
+│                                                                    public gated repos  │
+│                                                                    you can access'     │
+│                                                                    permission. Accept  │
+│                                                                    licenses at:        │
+│                                                                    https://hf.co/pyan… │
+│                                                                    https://hf.co/pyan… │
+│                                                                    https://hf.co/pyan… │
+│                                                                    [env var: HF_TOKEN] │
+│ --min-speakers                                INTEGER              Minimum number of   │
+│                                                                    speakers (optional  │
+│                                                                    hint for            │
+│                                                                    diarization).       │
+│ --max-speakers                                INTEGER              Maximum number of   │
+│                                                                    speakers (optional  │
+│                                                                    hint for            │
+│                                                                    diarization).       │
+│ --align-words           --no-align-words                           Use wav2vec2 forced │
+│                                                                    alignment for       │
+│                                                                    word-level speaker  │
+│                                                                    assignment (more    │
+│                                                                    accurate but        │
+│                                                                    slower).            │
+│                                                                    [default:           │
+│                                                                    no-align-words]     │
+│ --align-language                              TEXT                 Language code for   │
+│                                                                    word alignment      │
+│                                                                    model (e.g., 'en',  │
+│                                                                    'fr', 'de', 'es',   │
+│                                                                    'it').              │
+│                                                                    [default: en]       │
+│ --enroll-speakers                             TEXT                 Enroll current      │
+│                                                                    speaker labels or   │
+│                                                                    remembered profile  │
+│                                                                    IDs into persistent │
+│                                                                    voice profiles,     │
+│                                                                    e.g.                │
+│                                                                    SPEAKER_00=Alice or │
+│                                                                    UNKNOWN_001=Alice.  │
+│                                                                    For simple renames, │
+│                                                                    use agent-cli       │
+│                                                                    speakers rename.    │
+│ --identify-speakers     --no-identify-spe…                         Match diarized      │
+│                                                                    speakers against    │
+│                                                                    persistent voice    │
+│                                                                    profiles when       │
+│                                                                    profiles exist.     │
+│                                                                    [default:           │
+│                                                                    identify-speakers]  │
+│ --remember-unknown-…    --no-remember-unk…                         Persist unmatched   │
+│                                                                    speaker embeddings  │
+│                                                                    as stable           │
+│                                                                    UNKNOWN_### voice   │
+│                                                                    profiles.           │
+│                                                                    [default:           │
+│                                                                    no-remember-unknow… │
+│ --speaker-profiles-…                          PATH                 JSON file storing   │
+│                                                                    persistent speaker  │
+│                                                                    voice embeddings.   │
+│                                                                    [default:           │
+│                                                                    /home/runner/.conf… │
+│ --speaker-match-thr…                          FLOAT RANGE          Cosine-similarity   │
+│                                               [0.0<=x<=1.0]        threshold for       │
+│                                                                    matching diarized   │
+│                                                                    speakers to stored  │
+│                                                                    profiles.           │
+│                                                                    [default: 0.7]      │
 ╰────────────────────────────────────────────────────────────────────────────────────────╯
 
 ```