segment-create

name	segment-create
description	Full scaffolding workflow for creating a new Oh My Posh segment. Invoke when asked to add a new segment: generates the Go source, registers the type, creates documentation, updates the sidebar and JSON schema.

Segment scaffolding instructions

Goal

• Given user inputs (segment id, Go type name, title, category, description, properties, template), generate all required code and docs to add a new segment end-to-end, following repo conventions.

Inputs

• id: kebab/slug used as type and docs filename (e.g., new)
• goType: PascalCase name for the Go struct (e.g., New)
• title: human readable (e.g., New)
• category: one of cli|cloud|health|languages|music|scm|system|web
• description: one-line description
• properties: list of { key, type, title, description, default }
• template: default template string (e.g., {{.Text}})

Contract

• Idempotent: do not duplicate registrations, constants, map entries, sidebar links, or schema entries.
• Alphabetical insertions where applicable.
• Compile-ready Go code, formatted.
• Docs lint clean according to the markdown skill (.github/skills/markdown/SKILL.md).

Implementation steps

1. Create Go writer file: src/segments/<id>.go

• If file exists, skip creation.
• Use this template; include property consts for each property key.

package segments

import (
    "github.com/jandedobbeleer/oh-my-posh/src/segments/options"
    
)

 {{goType}}  {
    Base

    
    Text 
}


 (
{{#each properties}}
    
    {{ pascalCase this.key }} options.Property = 
{{/each}})

 Enabled()  {
    
    {{# (propExists properties )}}
    s.Text = s.props.GetString({{ pascalCase  }}, {{ defaultFor  }})
    {{}}
    s.Text = s.props.GetString({{ pascalCase (firstKey properties) }}, )
    {{/}}
     
}

 Template()  {
     {{ printf  template }}
}