@arnavpisces/sutra
v1.0.9
Published
Terminal TUI for Jira tickets and Confluence docs
Maintainers
Readme
sutra
Keyboard-first terminal TUI for Jira tickets and Confluence docs.
Search, browse, edit, comment, and manage attachments without leaving the terminal.
Built for day-to-day engineering workflows where speed matters.
Why This Exists
- Jira + Confluence in one fast terminal workflow.
- Better keyboard ergonomics than constantly context-switching to browser tabs.
- Local-first state: cache, bookmarks, recents, and config stay on your machine.
Requirements
- Node.js
20+ - Atlassian Cloud site + API token
Product Walkthrough
1) Browse tickets and inspect ticket sections

2) Add a ticket comment from detail view

3) Run JQL search (currentUser() example)

4) Search, view and edit Confluence doc

Features
Jira
- Browse tickets with pagination.
- Search with fuzzy query, quick filters, and JQL.
- View/edit ticket details, comments, status, and attachments.
Confluence
- Browse recent pages and browse by space.
- Search pages with CQL-backed queries.
- View markdown/mdcat rendering, edit pages, labels, comments, and attachments.
Shared
- Bookmarks + recent history.
- External editor integration (
$EDITOR, Cursor/VS Code fallback). - Persistent local cache via SQLite.
- Open in browser + copy URL shortcuts.
Install
npm install -g @arnavpisces/sutra
sutra setup
sutraSetup asks for:
- site username (for example
acme-team) - Atlassian API token (hidden input)
Sutra derives Jira/Confluence base URLs and validates credentials before entering control panels.
Key Shortcuts
Tab: switch Jira/Confluence/: search in browse and page viewsEsc: back to previous screenCtrl+E: open external editor (editable views)Ctrl+O: open in browserCtrl+Y: copy URLCtrl+B: bookmark
Contributing
- Issues: https://github.com/arnavpisces/sutra/issues
- Pull requests: https://github.com/arnavpisces/sutra/pulls
- Guidelines:
CONTRIBUTING.md - Code of conduct:
CODE_OF_CONDUCT.md - Security:
SECURITY.md
License
Apache-2.0, © 2026 Arnav Kumar.
Not affiliated with Atlassian.
