Skip to main content

​
Overview

The status tool provides a comprehensive health check of your SESHAT installation. Always call this first before performing any operations.
This tool is the entry point for the agentic experience. It helps you understand the current state before taking action.

​
Parameters

​
verbose
boolean
default:"false"
If true, include detailed per-project statistics and configuration.

​
Response

{
  "wallet": {
    "address": "0x1234...5678",
    "balance_eth": "0.05",
    "balance_usd": 100,
    "remaining_attestations": 50000
  },
  "git_host": {
    "status": "connected",
    "url": "https://api.github.com"
  },
  "database": {
    "status": "healthy",
    "total_records": 142,
    "by_project": {
      "my-project": 100,
      "other-project": 42
    },
    "by_category": {
      "research": 80,
      "pr": 50,
      "tag": 12
    }
  },
  "last_attestation": "2026-01-16T10:30:00Z",
  "projects": [
    {
      "id": "my-project",
      "name": "My Project",
      "has_repo": true,
      "has_vault": true,
      "has_git_host": true
    }
  ]
}

​
Response Fields

​
wallet
object
Ethereum wallet information.
​
git_host
object
Git host connectivity status.
​
database
object
Local SQLite ledger statistics.
​
last_attestation
string
ISO timestamp of the most recent attestation
​
projects
array
List of configured projects (only with verbose: true)

​
Warnings

The agent should warn the user if:
Low balance: If wallet.balance_eth < 0.01 ETH, warn that fewer than ~1000 attestations remain.
Git host disconnected: If git_host.status is not connected, PR and release sealing will fail.

​
Examples

​
Basic Health Check

Check SESHAT status

​
Verbose Mode

Check SESHAT status with verbose mode enabled

​
When to Use

ScenarioAction
Session startAlways check status first
Before bulk certificationVerify wallet has sufficient balance
After errorsCheck connectivity and database health
Before release bundleEnsure all systems operational