65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
# Package: dirigent_zed
|
|
|
|
Zed editor integration for Dirigent -- detection, agent discovery, binary resolution.
|
|
|
|
## Quick Facts
|
|
- **Type**: Library
|
|
- **Main Entry**: src/lib.rs
|
|
- **Dependencies**: dirigent_config, dirs, serde, serde_json, thiserror, tracing
|
|
- **Status**: Initial implementation
|
|
|
|
## Purpose
|
|
|
|
Detects Zed editor installations on the current system, discovers configured
|
|
ACP agents from Zed's `settings.json`, and resolves downloaded binary paths
|
|
from the Zed data directory.
|
|
|
|
## Key Types
|
|
|
|
- `ZedChannel` -- Release channel enum (Stable, Preview, Nightly, Dev)
|
|
- `ZedAgent` -- Discovered agent with name, type, binary path, env overrides
|
|
- `AgentServerType` -- Registry, Custom, or Extension
|
|
- `ZedInstallation` -- Detected installation with channel, paths, and agents
|
|
|
|
## Module Organization
|
|
|
|
- **`paths.rs`** -- Platform path resolution for Zed config/data directories
|
|
- **`agents.rs`** -- Agent discovery from settings.json, JSONC stripping, binary resolution
|
|
- **`detection.rs`** -- High-level installation detection combining paths and agents
|
|
|
|
## Platform Paths
|
|
|
|
| Platform | Config Dir | Data Dir |
|
|
|----------|-----------|----------|
|
|
| Linux | `$XDG_CONFIG_HOME/zed` | `$XDG_DATA_HOME/zed` |
|
|
| macOS | `~/.config/zed` | `~/Library/Application Support/Zed` |
|
|
| Windows | `%APPDATA%\Zed` | `%LOCALAPPDATA%\Zed` |
|
|
|
|
## Usage
|
|
|
|
```rust
|
|
let installations = dirigent_zed::detect_installations();
|
|
for inst in &installations {
|
|
for agent in &inst.agents {
|
|
if let Some(ref binary) = agent.binary_path {
|
|
println!("{}: {}", agent.name, binary.display());
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Testing
|
|
|
|
```bash
|
|
cargo test -p dirigent_zed
|
|
```
|
|
|
|
## Related Packages
|
|
|
|
- **dirigent_config** -- Dirigent's own path resolution (dependency)
|
|
- **dirigent_core** -- Will consume this crate for Zed connector integration (future)
|
|
|
|
## Research
|
|
|
|
See `docs/research/zed-integration.md` for detailed platform paths and detection strategies.
|