Skip to content

CLI tooling: apex command-line interface #15

@tac0turtle

Description

@tac0turtle

Summary

Implement a minimal CLI for apex operations and debugging.

Commands

apex start [--config path]            # Start the indexer service
apex status                           # Show sync status, head, lag, active subscriptions
apex blob get <height> <ns> <commit>  # Query a specific blob
apex blob list <height> [--ns <ns>]   # List blobs at a height, optionally filtered
apex config validate [--config path]  # Validate config file
apex config show [--config path]      # Print resolved config with defaults
apex version                          # Print version and build info

Implementation

  • Use spf13/cobra for command structure
  • CLI commands are thin wrappers around the JSON-RPC client (same pattern as celestia-node)
  • apex start is the main entrypoint that wires everything together
  • apex status / apex blob get connect to a running instance via RPC
  • JSON output by default, --format table for human-readable

Non-goals

References

  • celestia-node CLI pattern: thin RPC client wrappers via cobra

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions