Skip to content

feat(acp): expose context window usage and project rules to IDE#1005

Merged
bug-ops merged 5 commits intomainfrom
worktree-issue-1002-acp-context-rules
Feb 27, 2026
Merged

feat(acp): expose context window usage and project rules to IDE#1005
bug-ops merged 5 commits intomainfrom
worktree-issue-1002-acp-context-rules

Conversation

@bug-ops
Copy link
Owner

@bug-ops bug-ops commented Feb 27, 2026

Closes #1002

Summary

  • Context widget (4% · 5.6k / 144k): unstable-session-usage enabled by default in zeph-acp; UsageUpdate emitted after each LLM response populates the token badge in Zed IDE
  • Rules widget (N project rules): new collect_project_rules helper globs .claude/rules/*.md from session cwd + skill file basenames; sent as _meta.projectRules: [{name: "..."}] in NewSessionResponse
  • ZephAcpAgent::with_project_rules() builder for supplying rules to the ACP agent
  • Wired through both stdio and HTTP transports
  • CHANGELOG, README, and docs/src/advanced/acp.md updated

Test plan

  • Build with --features acp and start zeph with orchestrator config
  • Open Zed IDE — verify "N project rules" badge appears on session start
  • Send a message — verify "Context N% · Xk / Yk" badge updates after response
  • cargo nextest run --workspace --lib --bins — 2944 tests pass

@github-actions github-actions bot added enhancement New feature or request size/L documentation Improvements or additions to documentation rust and removed enhancement New feature or request size/L labels Feb 27, 2026
Enable the unstable-session-usage feature in zeph-acp by default so that
UsageUpdate (used/size tokens) is emitted after each LLM response. Zed
renders this as the "Context N% · Xk / Yk" badge in the agent panel.

Add project rules reporting: collect_project_rules in src/acp.rs globs
.claude/rules/*.md relative to the session cwd and includes skill file
basenames. ZephAcpAgent.with_project_rules() populates _meta.projectRules
in NewSessionResponse as [{name: "file.md"}, ...]. Zed renders this as
the "N project rules" badge on session start.

Closes #1002
UsageUpdate notifications are sent per ACP spec but IDE rendering
depends on client-side support. _meta.projectRules is a Zeph
extension not yet consumed by Zed's native project rules badge.

Update both docs and README to reflect actual behavior.
@bug-ops bug-ops force-pushed the worktree-issue-1002-acp-context-rules branch from 4bc2a06 to 13ba3b4 Compare February 27, 2026 01:43
@bug-ops bug-ops enabled auto-merge (squash) February 27, 2026 01:44
@bug-ops bug-ops merged commit 5631431 into main Feb 27, 2026
28 checks passed
@bug-ops bug-ops deleted the worktree-issue-1002-acp-context-rules branch February 27, 2026 02:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request rust size/L

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(acp): expose context window usage and loaded rules via ACP session updates

1 participant