README
¶
CLI for DataTug agent
You can download DataTug agent or build it from source codes.
How to run
To display help:
datatug --help
Commands:
- init
- scan
- serve
Command: init
Command: scan
Command: serve
Recover an interrupted session run
session send --op <original-operation-id> reads accepted work and never repeats its provider call. Inspect an uncertain run and the current session before deciding whether to resolve it:
datatug session --project my-project run run-id
datatug session --project my-project show session-id
To explicitly mark an accepted client run as outcome unknown, save the following as resolve-unknown.json. Replace the session/run IDs, kind, and both versions with the values just read. Use a unique operation ID for this decision; keep it unchanged when recovering its acknowledgement.
{
"opId": "resolve-interrupted-001",
"action": "reportClientRun",
"sessionId": "session-id",
"runId": "run-id",
"kind": "chat",
"expectedVersion": 2,
"expectedRunVersion": 1,
"runState": "outcome-unknown",
"errorCode": "CLIENT_OUTCOME_UNKNOWN"
}
datatug session --project my-project command --input resolve-unknown.json
This records an explicit unknown outcome and releases the session's pending-run count. It executes no source or provider work and attaches no result. Server-owned runs reject this command. An intentional rerun requires a new operation ID.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package datatugui is the application layer of the DataTug terminal UI: the registry of root modules, the shared main menu, the Bubble Tea app model that hosts the tuigoff navigation shell, and the helpers every screen uses.
|
Package datatugui is the application layer of the DataTug terminal UI: the registry of root modules, the shared main menu, the Bubble Tea app model that hosts the tuigoff navigation shell, and the helpers every screen uses. |
|
dtapiservice
Package dtapiservice is the API Monitor screen of the DataTug terminal UI.
|
Package dtapiservice is the API Monitor screen of the DataTug terminal UI. |
|
dtproject
Package dtproject is the Projects module of the DataTug terminal UI: the list of local and GitHub projects, the screens of an open project, the wizard that creates a project and the flow that adds DataTug to an existing GitHub repository.
|
Package dtproject is the Projects module of the DataTug terminal UI: the list of local and GitHub projects, the screens of an open project, the wizard that creates a project and the flow that adds DataTug to an existing GitHub repository. |
|
dtsettings
Package dtsettings is the Settings screen of the DataTug terminal UI: the config file, syntax highlighted.
|
Package dtsettings is the Settings screen of the DataTug terminal UI: the config file, syntax highlighted. |
|
dtviewers/clouds
Package clouds holds what the cloud viewers (Google Cloud, AWS, Azure) share.
|
Package clouds holds what the cloud viewers (Google Cloud, AWS, Azure) share. |
|
dtviewers/clouds/aws/awsui
Package awsui is the Amazon Web Services viewer.
|
Package awsui is the Amazon Web Services viewer. |
|
dtviewers/clouds/azure/azureui
Package azureui is the Microsoft Azure viewer.
|
Package azureui is the Microsoft Azure viewer. |
|
dtviewers/clouds/gcloud/gcloudui
Package gcloudui is the Google Cloud viewer: projects, credentials and the Firestore databases of a project.
|
Package gcloudui is the Google Cloud viewer: projects, credentials and the Firestore databases of a project. |
|
dtviewers/dbviewer
Package dbviewer is the DB viewer of the Viewers module: a chooser of database kinds, the SQLite and inGitDB home screens, and the browser of one database (tables and views, their columns, foreign keys, referrers and content).
|
Package dbviewer is the DB viewer of the Viewers module: a chooser of database kinds, the SQLite and inGitDB home screens, and the browser of one database (tables and views, their columns, foreign keys, referrers and content). |