config

package

v0.3.0 Latest Latest Go to latest Published: Apr 17, 2026 License: MIT Imports: 9 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/brainjar-sh/brainjar

Links

Open Source Insights

Documentation ¶

Index ¶

Constants
func ConfigPath(home string) string
func DBPath(home string) string
func IsNotExist(err error) bool
func ResolveHome(homeFlag string) (string, error)
func Save(home string, cfg *Config) error
type Config
- func Defaults() Config
- func Load(home string) (*Config, error)

Constants ¶

View Source

const (
	EnvHome    = "BRAINJAR_HOME"
	ConfigFile = "config.yaml"
	DBFile     = "brainjar.db"
)

View Source

const ConfigSchemaVersion = 1

ConfigSchemaVersion is bumped when the on-disk YAML schema changes in a non-backwards-compatible way. `Load` refuses to read unknown versions.

View Source

const DefaultPlatform = "claude"

DefaultPlatform is the adapter used when a workspace is initialized without an explicit choice. Kept here (rather than imported from internal/platform) so pkg/config stays dependency-free.

Variables ¶

This section is empty.

Functions ¶

func ConfigPath ¶

func ConfigPath(home string) string

ConfigPath returns the absolute path to the config file inside home.

func DBPath ¶

func DBPath(home string) string

DBPath returns the absolute path to the SQLite database inside home.

func IsNotExist ¶

func IsNotExist(err error) bool

IsNotExist reports whether err indicates the config file is missing.

func ResolveHome ¶

func ResolveHome(homeFlag string) (string, error)

ResolveHome returns the brainjar home directory.

Precedence, highest wins:

homeFlag (the --home flag value, empty if unset)
$BRAINJAR_HOME
$HOME/.brainjar

func Save ¶

func Save(home string, cfg *Config) error

Save writes cfg to <home>/config.yaml with 0o600 perms. The home dir must already exist.

Types ¶

type Config ¶

type Config struct {
	// SchemaVersion is the config file's schema version. Set by `init`.
	SchemaVersion int `yaml:"schema_version" koanf:"schema_version"`

	// WorkspaceID is the stable UUID of the workspace this home directory
	// is bound to. Set by `init`. Names can drift; IDs don't.
	WorkspaceID string `yaml:"workspace_id" koanf:"workspace_id"`

	// Platform is the slug of the agent-runtime adapter used by
	// `brainjar sync` and `brainjar hooks *`. Defaults to "claude".
	Platform string `yaml:"platform" koanf:"platform"`
}

Config is the on-disk CLI configuration. One instance per home dir.

func Defaults ¶

func Defaults() Config

Defaults returns a Config with the compiled-in default values.

func Load ¶

func Load(home string) (*Config, error)

Load reads the config at <home>/config.yaml. Returns a wrapped os.ErrNotExist if the file is missing — callers (e.g. `init`) can detect this with errors.Is.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL