filelinks v1.1.0

filelinks v1.1.0

Release date: 2026-05-31
Milestone: v1.1 AI agent integration

Highlights

• Added agent run policy support in core (trigger-only, trigger-or-affects) with staged trigger/affect coverage classification.
• Added provider architecture with Cursor as the first provider and typed runtime/startup/missing-key errors.
• Added filelinks check --run-agents for opt-in agent execution after normal violation reporting.
• Added prompt assembly context for agents (resolved prompt config, trigger staged diff, readable affected file contents).
• Expanded filelinks add wizard with:
  • optional global/per-link agent + prompt setup,
  • live model discovery + fallback options,
  • model variant labels (default, Standard, Fast, etc.),
  • debounced model search in picker.
• Added Cursor API key precedence for CLI agent runs and model discovery:
  • --cursor-api-key (where supported),
  • CURSOR_API_KEY environment variable,
  • .env.local / .env under the effective --cwd.

User-facing changes

filelinks check

• New flag: --run-agents
• JSON mode now includes optional agentRuns summaries when agents are executed.
• Agent run policy default is trigger-only unless overridden in config.

filelinks add

• Interactive model picker now supports:
  • sorted model/variant lists,
  • meaningful labels focused on deltas from default presets,
  • input filtering with debounce for large model catalogs.

Config additions

agent config now supports:

• runPolicy
• provider
• runtime (local / cloud)
• model
• modelParams (variant params from model picker)
• local.cwd
• cloud.repos

Notes

• Cursor is the only provider implemented in v1.1.
• Existing check violation behavior and exit-code semantics remain intact.
• filelinks add remains interactive-only (no --json mode).