ectop is a powerful Textual-based Terminal User Interface (TUI) for monitoring and controlling ecFlow servers.
- Real-time Monitoring: View the status of your ecFlow suites, families, and tasks in a hierarchical tree view.
- Node Management: Suspend, resume, kill, and force-complete nodes directly from the TUI.
- File Inspection: View job output logs, scripts, and job files for any node.
- Search: Quickly find nodes in large trees with live search and lazy loading.
- Command Palette: Access all features via a searchable command interface.
- Why?: Inspect why a node is in its current state, including triggers and limits.
- Variable Management: View and modify node variables on the fly.
- Interactive Script Editing: Edit scripts in your preferred editor and update them on the server.
conda env create -f environment.yml
conda activate ectoppip install .Note: ecflow must be installed on your system. It is typically available via Conda.
Start ectop by running:
ectopBy default, it connects to localhost:3141.
| Key | Action |
|---|---|
q |
Quit |
p |
Command Palette |
r |
Refresh Tree |
l |
Load Logs/Script for selected node |
s |
Suspend selected node |
u |
Resume selected node |
k |
Kill selected node |
f |
Force Complete selected node |
/ |
Search nodes |
w |
Why? (Inspect dependencies) |
e |
Edit & Rerun script |
t |
Toggle Live Log updates |
v |
View/Edit Variables |
Full documentation is available at https://noaa-emc.github.io/ectop/.
This project is licensed under the CC0 1.0 Universal License.
Important
Disclaimer: This software is provided "as is". Please see the full DISCLAIMER.md for legal information regarding its use in production environments and software.