Skip to content

Node-scoped read-only console powered by hidden accelerated distributed queries#909

Merged
javuto merged 2 commits into
developfrom
web-console-queries-accelerated
Jul 21, 2026
Merged

Node-scoped read-only console powered by hidden accelerated distributed queries#909
javuto merged 2 commits into
developfrom
web-console-queries-accelerated

Conversation

@javuto

@javuto javuto commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a node-scoped read-only console powered by hidden accelerated osquery distributed queries.

Changes

  • Added console distributed query type for internal console commands.
  • Console queries are hidden from normal query lists and hidden-query tabs.
  • Pending console queries request accelerated delivery when returned to osquery.
  • Added console sessions with per-session working directory.
  • Added read-only shell-like commands:
    • pwd
    • help
    • clear
    • ls [path]
    • stat <path>
    • ps
    • cd <path>
    • sql <select ...>
  • Enforced one in-flight command per console session.
  • Added console API routes gated by QueryLevel permissions.
  • Added session ownership checks so users cannot drive another user's console session.
  • Added React console UI with pending spinner, result rendering, and polling.
  • Added Console button on node detail pages only when accelerated mode is enabled.
  • Exposed accelerated through /api/v1/features.

Validation

  • go test ./pkg/queries ./pkg/console ./cmd/api ./cmd/tls/handlers ./cmd/tls
  • go test ./cmd/api/handlers -run Console
  • go test ./cmd/api/handlers -run Features
  • npm test -- NodeConsolePage.test.tsx
  • npm test -- NodeDetailPage.test.tsx EnvConfigPage.test.tsx
  • npm run check
  • npm run build

Notes

  • V1 is read-only.
  • cat is intentionally unsupported because osquery does not expose arbitrary file contents.
  • The Console UI is hidden unless osquery.accelerated is enabled.
  • Vite build passes with the existing large chunk-size warning.

@javuto javuto added ✨ enhancement New feature or request osctrl-api osctrl-api related changes queries On-demand queries related issues ⭐️ frontend Frontend related issues labels Jul 21, 2026
Comment thread cmd/api/handlers/console.go Fixed
… between integer types'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
@javuto
javuto merged commit e0b6b63 into develop Jul 21, 2026
8 checks passed
@javuto
javuto deleted the web-console-queries-accelerated branch July 21, 2026 20:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

✨ enhancement New feature or request ⭐️ frontend Frontend related issues osctrl-api osctrl-api related changes queries On-demand queries related issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants