AnkTechsol / AnkTechsol/Satya_AI

Add "satya-explorer" CLI/TUI for browsing audit logs

Open
#165 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
8
Forks
6
PR merge metrics
No merged PRs in 30d

Description

Satya stores detailed audit logs in a lightweight backend (flat files or SQLite), but exploring them currently requires either using the dashboard or writing custom queries/scripts. Power users and infra folks often prefer quick, terminal-based exploration.

A small `satya-explorer` CLI/TUI would make it easier to inspect agent activity and debug workflows directly from the terminal.

Task
----

Design and implement a read-only CLI (and optional TUI) that can:

1. Connect to the existing Satya storage:
- SQLite DB if configured
- otherwise the default flat-file store

2. Provide useful filters:
- by agent name
- by task status / error flags
- by time range
- by tags / labels

3. Render concise outputs:
- list tasks with status and timestamps
- show full details for a single task (events, messages, etc.)

Implementation Steps
--------------------

- [ ] Decide on CLI structure and add an entry point via `pyproject.toml` / `setup.cfg`
- [ ] Implement read-only queries for SQLite and file-backed storage
- [ ] (Optional) Add a minimal TUI view using a Python TUI library
- [ ] Add docs: **"Inspect Satya audit logs from your terminal"** and link from the main `README.md`

Resources
---------

- • Audit log schema / storage implementation in this repo
- • Existing logging / ROI features described in docs

Why This Matters
----------------

A terminal-first explorer is great for demos, debugging, and social posts (screenshots/GIFs), and it appeals to contributors who enjoy building observability tooling.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.