Rename service describe/show to get

Author: nathanjcochran

CLAUDE.md

@@ -150,7 +150,7 @@ Tiger CLI is a Go-based command-line interface for managing Tiger, the modern da
 - **Command Structure**: `internal/tiger/cmd/` - Cobra-based command definitions
   - `root.go` - Root command with global flags and configuration initialization
   - `auth.go` - Authentication commands (login, logout, whoami)
-  - `service.go` - Service management commands (list, create, describe, fork, delete, update-password)
+  - `service.go` - Service management commands (list, create, get, fork, delete, update-password)
   - `db.go` - Database operation commands (connection-string, connect, test-connection)
   - `config.go` - Configuration management commands (show, set, unset, reset)
   - `mcp.go` - MCP server commands (install, start)
@@ -160,7 +160,7 @@ Tiger CLI is a Go-based command-line interface for managing Tiger, the modern da
 - **API Client**: `internal/tiger/api/` - Generated OpenAPI client with mocks
 - **MCP Server**: `internal/tiger/mcp/` - Model Context Protocol server implementation
   - `server.go` - MCP server initialization, tool registration, and lifecycle management
-  - `service_tools.go` - Service management tools (list, show, create, update-password)
+  - `service_tools.go` - Service management tools (list, get, create, update-password)
   - `db_tools.go` - Database operation tools (execute-query)
   - `proxy.go` - Proxy client that forwards tools/resources/prompts from remote docs MCP server
 - **Password Storage**: `internal/tiger/password/` - Secure password storage utilities

README.md

@@ -84,7 +84,7 @@ Tiger CLI provides the following commands:
 - `tiger service` - Service lifecycle management
   - `list` - List all services
   - `create` - Create a new service
-  - `describe` - Show detailed service information
+  - `get` - Show detailed service information (aliases: `describe`, `show`)
   - `fork` - Fork an existing service
   - `delete` - Delete a service
   - `update-password` - Update service master password
@@ -162,7 +162,7 @@ The MCP server exposes the following tools to AI assistants:
 
 **Service Management:**
 - `service_list` - List all database services in your project
-- `service_show` - Show detailed information about a specific service
+- `service_get` - Get detailed information about a specific service
 - `service_create` - Create new database services with configurable resources
 - `service_update_password` - Update the master password for a service
 

internal/tiger/cmd/integration_test.go

@@ -214,22 +214,22 @@ func TestServiceLifecycleIntegration(t *testing.T) {
 		}
 	})
 
-	t.Run("DescribeService", func(t *testing.T) {
+	t.Run("GetService", func(t *testing.T) {
 		if serviceID == "" {
 			t.Skip("No service ID available from create test")
 		}
 
-		t.Logf("Describing service: %s", serviceID)
+		t.Logf("Getting service details: %s", serviceID)
 
 		output, err := executeIntegrationCommand(
-			"service", "describe", serviceID,
+			"service", "get", serviceID,
 			"--output", "json",
 		)
 
-		t.Logf("Raw service describe output: %s", output)
+		t.Logf("Raw service get output: %s", output)
 
 		if err != nil {
-			t.Fatalf("Service describe failed: %v\nOutput: %s", err, output)
+			t.Fatalf("Service get failed: %v\nOutput: %s", err, output)
 		}
 
 		// Parse JSON to verify service details
@@ -388,14 +388,14 @@ func TestServiceLifecycleIntegration(t *testing.T) {
 
 		t.Logf("Verifying service %s no longer exists", deletedServiceID)
 
-		// Try to describe the deleted service - should fail
+		// Try to get the deleted service - should fail
 		output, err := executeIntegrationCommand(
-			"service", "describe", deletedServiceID,
+			"service", "get", deletedServiceID,
 		)
 
 		// We expect this to fail since the service should be deleted
 		if err == nil {
-			t.Errorf("Expected service describe to fail for deleted service, but got output: %s", output)
+			t.Errorf("Expected service get to fail for deleted service, but got output: %s", output)
 		}
 
 		// Check that error indicates service not found
@@ -531,8 +531,8 @@ func TestServiceNotFound(t *testing.T) {
 		reason           string
 	}{
 		{
-			name:             "service describe",
-			args:             []string{"service", "describe", nonExistentServiceID},
+			name:             "service get",
+			args:             []string{"service", "get", nonExistentServiceID},
 			expectedExitCode: ExitServiceNotFound,
 		},
 		{
@@ -703,8 +703,8 @@ func TestAuthenticationErrorsIntegration(t *testing.T) {
 			args: []string{"service", "list", "--project-id", projectID},
 		},
 		{
-			name: "service describe",
-			args: []string{"service", "describe", "non-existent-service", "--project-id", projectID},
+			name: "service get",
+			args: []string{"service", "get", "non-existent-service", "--project-id", projectID},
 		},
 		{
 			name: "service create",

internal/tiger/cmd/service.go

@@ -34,7 +34,7 @@ func buildServiceCmd() *cobra.Command {
 	}
 
 	// Add all subcommands
-	cmd.AddCommand(buildServiceDescribeCmd())
+	cmd.AddCommand(buildServiceGetCmd())
 	cmd.AddCommand(buildServiceListCmd())
 	cmd.AddCommand(buildServiceCreateCmd())
 	cmd.AddCommand(buildServiceDeleteCmd())
@@ -44,31 +44,32 @@ func buildServiceCmd() *cobra.Command {
 	return cmd
 }
 
-// serviceDescribeCmd represents the describe command under service
-func buildServiceDescribeCmd() *cobra.Command {
+// buildServiceGetCmd represents the get command under service
+func buildServiceGetCmd() *cobra.Command {
 	var withPassword bool
 
 	cmd := &cobra.Command{
-		Use:   "describe [service-id]",
-		Short: "Show detailed information about a service",
+		Use:     "get [service-id]",
+		Aliases: []string{"describe", "show"},
+		Short:   "Show detailed information about a service",
 		Long: `Show detailed information about a specific database service.
 
 The service ID can be provided as an argument or will use the default service
 from your configuration. This command displays comprehensive information about
 the service including configuration, status, endpoints, and resource usage.
 
 Examples:
-  # Describe default service
-  tiger service describe
+  # Get default service details
+  tiger service get
 
-  # Describe specific service
-  tiger service describe svc-12345
+  # Get specific service details
+  tiger service get svc-12345
 
   # Get service details in JSON format
-  tiger service describe svc-12345 --output json
+  tiger service get svc-12345 --output json
 
   # Get service details in YAML format
-  tiger service describe svc-12345 --output yaml`,
+  tiger service get svc-12345 --output yaml`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			// Get config
 			cfg, err := config.Load()

internal/tiger/cmd/service_test.go

@@ -558,7 +558,7 @@ func TestAutoGeneratedServiceName(t *testing.T) {
 	}
 }
 
-func TestServiceDescribe_NoServiceID(t *testing.T) {
+func TestServiceGet_NoServiceID(t *testing.T) {
 	tmpDir := setupServiceTest(t)
 
 	// Set up config with project ID but no default service ID
@@ -577,8 +577,8 @@ func TestServiceDescribe_NoServiceID(t *testing.T) {
 	}
 	defer func() { getAPIKeyForService = originalGetAPIKey }()
 
-	// Execute service describe command without service ID
-	_, err, _ = executeServiceCommand("service", "describe")
+	// Execute service get command without service ID
+	_, err, _ = executeServiceCommand("service", "get")
 	if err == nil {
 		t.Fatal("Expected error when no service ID is provided or configured")
 	}
@@ -588,7 +588,7 @@ func TestServiceDescribe_NoServiceID(t *testing.T) {
 	}
 }
 
-func TestServiceDescribe_NoAuth(t *testing.T) {
+func TestServiceGet_NoAuth(t *testing.T) {
 	tmpDir := setupServiceTest(t)
 
 	// Set up config with project ID and service ID
@@ -608,8 +608,8 @@ func TestServiceDescribe_NoAuth(t *testing.T) {
 	}
 	defer func() { getAPIKeyForService = originalGetAPIKey }()
 
-	// Execute service describe command
-	_, err, _ = executeServiceCommand("service", "describe")
+	// Execute service get command
+	_, err, _ = executeServiceCommand("service", "get")
 	if err == nil {
 		t.Fatal("Expected error when not authenticated")
 	}

internal/tiger/mcp/service_tools.go

@@ -79,24 +79,24 @@ func setServiceIDSchemaProperties(schema *jsonschema.Schema) {
 	schema.Properties["service_id"].Pattern = "^[a-z0-9]{10}$"
 }
 
-// ServiceShowInput represents input for service_show
-type ServiceShowInput struct {
+// ServiceGetInput represents input for service_get
+type ServiceGetInput struct {
 	ServiceID string `json:"service_id"`
 }
 
-func (ServiceShowInput) Schema() *jsonschema.Schema {
-	schema := util.Must(jsonschema.For[ServiceShowInput](nil))
+func (ServiceGetInput) Schema() *jsonschema.Schema {
+	schema := util.Must(jsonschema.For[ServiceGetInput](nil))
 	setServiceIDSchemaProperties(schema)
 	return schema
 }
 
-// ServiceShowOutput represents output for service_show
-type ServiceShowOutput struct {
+// ServiceGetOutput represents output for service_get
+type ServiceGetOutput struct {
 	Service ServiceDetail `json:"service"`
 }
 
-func (ServiceShowOutput) Schema() *jsonschema.Schema {
-	return util.Must(jsonschema.For[ServiceShowOutput](nil))
+func (ServiceGetOutput) Schema() *jsonschema.Schema {
+	return util.Must(jsonschema.For[ServiceGetOutput](nil))
 }
 
 // ServiceDetail represents detailed service information
@@ -231,19 +231,19 @@ func (s *Server) registerServiceTools() {
 		},
 	}, s.handleServiceList)
 
-	// service_show
+	// service_get
 	mcp.AddTool(s.mcpServer, &mcp.Tool{
-		Name:  "service_show",
-		Title: "Show Service Details",
+		Name:  "service_get",
+		Title: "Get Service Details",
 		Description: "Get detailed information for a specific database service. " +
 			"Returns connection endpoints, replica configuration, resource allocation, creation time, and status.",
-		InputSchema:  ServiceShowInput{}.Schema(),
-		OutputSchema: ServiceShowOutput{}.Schema(),
+		InputSchema:  ServiceGetInput{}.Schema(),
+		OutputSchema: ServiceGetOutput{}.Schema(),
 		Annotations: &mcp.ToolAnnotations{
 			ReadOnlyHint: true,
-			Title:        "Show Service Details",
+			Title:        "Get Service Details",
 		},
-	}, s.handleServiceShow)
+	}, s.handleServiceGet)
 
 	// service_create
 	mcp.AddTool(s.mcpServer, &mcp.Tool{
@@ -333,21 +333,21 @@ func (s *Server) handleServiceList(ctx context.Context, req *mcp.CallToolRequest
 	}
 }
 
-// handleServiceShow handles the service_show MCP tool
-func (s *Server) handleServiceShow(ctx context.Context, req *mcp.CallToolRequest, input ServiceShowInput) (*mcp.CallToolResult, ServiceShowOutput, error) {
+// handleServiceGet handles the service_get MCP tool
+func (s *Server) handleServiceGet(ctx context.Context, req *mcp.CallToolRequest, input ServiceGetInput) (*mcp.CallToolResult, ServiceGetOutput, error) {
 	// Load config and validate project ID
 	cfg, err := s.loadConfigWithProjectID()
 	if err != nil {
-		return nil, ServiceShowOutput{}, err
+		return nil, ServiceGetOutput{}, err
 	}
 
 	// Create fresh API client with current credentials
 	apiClient, err := s.createAPIClient()
 	if err != nil {
-		return nil, ServiceShowOutput{}, err
+		return nil, ServiceGetOutput{}, err
 	}
 
-	logging.Debug("MCP: Showing service details",
+	logging.Debug("MCP: Getting service details",
 		zap.String("project_id", cfg.ProjectID),
 		zap.String("service_id", input.ServiceID))
 
@@ -357,31 +357,31 @@ func (s *Server) handleServiceShow(ctx context.Context, req *mcp.CallToolRequest
 
 	resp, err := apiClient.GetProjectsProjectIdServicesServiceIdWithResponse(ctx, cfg.ProjectID, input.ServiceID)
 	if err != nil {
-		return nil, ServiceShowOutput{}, fmt.Errorf("failed to get service details: %w", err)
+		return nil, ServiceGetOutput{}, fmt.Errorf("failed to get service details: %w", err)
 	}
 
 	// Handle API response
 	switch resp.StatusCode() {
 	case 200:
 		if resp.JSON200 == nil {
-			return nil, ServiceShowOutput{}, fmt.Errorf("empty response from API")
+			return nil, ServiceGetOutput{}, fmt.Errorf("empty response from API")
 		}
 
 		service := *resp.JSON200
-		output := ServiceShowOutput{
+		output := ServiceGetOutput{
 			Service: s.convertToServiceDetail(service),
 		}
 
 		return nil, output, nil
 
 	case 401:
-		return nil, ServiceShowOutput{}, fmt.Errorf("authentication failed: invalid API key")
+		return nil, ServiceGetOutput{}, fmt.Errorf("authentication failed: invalid API key")
 	case 403:
-		return nil, ServiceShowOutput{}, fmt.Errorf("permission denied: insufficient access to service")
+		return nil, ServiceGetOutput{}, fmt.Errorf("permission denied: insufficient access to service")
 	case 404:
-		return nil, ServiceShowOutput{}, fmt.Errorf("service '%s' not found in project '%s'", input.ServiceID, cfg.ProjectID)
+		return nil, ServiceGetOutput{}, fmt.Errorf("service '%s' not found in project '%s'", input.ServiceID, cfg.ProjectID)
 	default:
-		return nil, ServiceShowOutput{}, fmt.Errorf("API request failed with status %d", resp.StatusCode())
+		return nil, ServiceGetOutput{}, fmt.Errorf("API request failed with status %d", resp.StatusCode())
 	}
 }
 

specs/spec.md

@@ -73,7 +73,7 @@ For the initial v0 release, implement these essential commands first:
 
 **Core Service Management:**
 - `tiger service list` - List all services
-- `tiger service describe` - Show service details
+- `tiger service get` - Show service details (aliases: `describe`, `show`)
 - `tiger service create` - Create new services
 - `tiger service delete` - Delete services with confirmation
 - `tiger service update-password` - Update service master password
@@ -172,7 +172,7 @@ Manage database services.
 
 **Subcommands:**
 - `list`: List all services
-- `describe`: Show service details
+- `get`: Show service details (aliases: `describe`, `show`)
 - `create`: Create a new service
 - `delete`: Delete a service
 - `start`: Start a service
@@ -207,9 +207,11 @@ tiger service list
 tiger services list
 tiger svc list
 
-# Show service details
-tiger service describe svc-12345
-tiger svc describe svc-12345
+# Show service details (all forms work)
+tiger service get svc-12345
+tiger service describe svc-12345  # alias
+tiger service show svc-12345      # alias
+tiger svc get svc-12345
 
 # Create a TimescaleDB service
 tiger service create \
@@ -685,7 +687,7 @@ svc-12345  production-db  running   production
 Errors are returned with descriptive messages and appropriate exit codes:
 
 ```bash
-$ tiger service describe invalid-id
+$ tiger service get invalid-id
 Error: Service 'invalid-id' not found in project 'proj-12345'
 Use 'tiger service list' to see available services.
 ```
@@ -795,7 +797,7 @@ tiger db connection-string svc-12345
 ### Monitoring and Maintenance
 ```bash
 # Check service status
-tiger service describe svc-12345
+tiger service get svc-12345
 
 # Update service password
 tiger service update-password svc-12345 --password new-secure-password
@@ -811,7 +813,7 @@ Commands follow consistent patterns for specifying service IDs:
 **Single-service commands** (verbs acting on one service):
 - Use positional `<service-id>` as the canonical parameter
 - Support `--service-id` flag as an alias/override
-- Examples: `tiger service describe <service-id>`, `tiger db connect <service-id>`
+- Examples: `tiger service get <service-id>`, `tiger db connect <service-id>`
 
 **Global context commands** (acting on other resources with service as secondary):
 - Use `--service-id` flag as the canonical parameter