harivansh-afk/deskctl
1
1
Fork 0
mirror of https://github.com/harivansh-afk/deskctl.git synced 2026-04-15 09:01:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
deskctl/AGENTS.md
Harivansh Rathi 03dfd6b6ea Phase 6: utility commands, SKILL.md, AGENTS.md, README.md 
- Implement screen_size via xcap Monitor, mouse_position via x11rb
  query_pointer, standalone screenshot with optional annotation,
  launch for spawning detached processes
- Handler dispatchers for get-screen-size, get-mouse-position,
  screenshot, launch
- SKILL.md agent discovery file with allowed-tools frontmatter
- AGENTS.md contributor guidelines for AI agents
- README.md with installation, quick start, architecture overview
2026-03-24 21:40:29 -04:00

1 KiB
Raw Blame History

Agent Guidelines

Build

cargo build
cargo clippy

Run

Requires an X11 session with DISPLAY set.

cargo run -- snapshot
cargo run -- --json snapshot --annotate

Code Style

  • No emojis in code or comments
  • Use anyhow::Result for all fallible functions
  • All daemon handler functions are async
  • Match field naming between CLI args, NDJSON protocol, and JSON output

Architecture

  • src/cli/ - clap CLI parser and client-side socket connection
  • src/daemon/ - tokio async daemon, request handler, state management
  • src/backend/ - DesktopBackend trait and X11 implementation
  • src/core/ - shared types, protocol, ref map, session detection

Adding a New Command

  1. Add the variant to Command enum in src/cli/mod.rs
  2. Add request building in build_request() in src/cli/mod.rs
  3. Add the action handler in src/daemon/handler.rs
  4. Add the backend method to DesktopBackend trait in src/backend/mod.rs
  5. Implement in src/backend/x11.rs
  6. Update SKILL.md