Documentation
¶
Index ¶
- Constants
- Variables
- func Execute(args []string) error
- func NewRootCmd() *cobra.Command
- func OutputList[T any](app *App, ctx context.Context, items []T, emptyMessage string, ...) error
- func WithApp(ctx context.Context, app *App) context.Context
- type App
- func (a *App) AccountIDList() []string
- func (a *App) AccountParams() url.Values
- func (a *App) AddAccountIDs(params url.Values)
- func (a *App) AgentHandlesEnabled(ctx context.Context) bool
- func (a *App) Backend() string
- func (a *App) BaseURL() string
- func (a *App) Client(ctx context.Context) (*api.Client, error)
- func (a *App) ColorEnabled(ctx context.Context) bool
- func (a *App) Confirm(prompt string) (bool, error)
- func (a *App) IsAgentOutput(ctx context.Context) bool
- func (a *App) IsTextLikeOutput(ctx context.Context) bool
- func (a *App) IsTextOutput(ctx context.Context) bool
- func (a *App) Output(ctx context.Context, data any, textFn func(io.Writer)) error
- func (a *App) OutputEvent(ctx context.Context, data any, textFn func(io.Writer)) error
- func (a *App) OutputFormat(ctx context.Context) string
- func (a *App) OutputTextf(ctx context.Context, data any, format string, args ...any) error
- func (a *App) ProgressWriter(ctx context.Context) io.Writer
- func (a *App) RecordChatHandles(ctx context.Context, chats []api.Chat)
- func (a *App) RecordContactHandles(ctx context.Context, chats []api.Chat)
- func (a *App) RecordInboxHandles(ctx context.Context, items []domain.InboxItem)
- func (a *App) RecordMessageHandles(ctx context.Context, messages []api.Message)
- func (a *App) ResolveAlias(ctx context.Context, client *api.Client, input string) (string, error)
- func (a *App) ResolveChatByName(ctx context.Context, client *api.Client, name string, ...) (string, error)
- func (a *App) ResolveChatHandle(ctx context.Context, ref cli.HandleRef) (string, error)
- func (a *App) ResolveChatIDFromArgOrFlag(ctx context.Context, client *api.Client, args []string, name, label string, ...) (string, error)
- func (a *App) ResolveChatIDFromFlags(ctx context.Context, client *api.Client, name, chatID, nameFlag, idFlag string, ...) (string, error)
- func (a *App) ResolveMessageHandle(ctx context.Context, ref cli.HandleRef) (string, string, error)
- func (a *App) Table(ctx context.Context, w io.Writer, headers []string) *outfmt.TableWriter
- type Config
- type InboxItem
Constants ¶
const ( BackendAPI = backend.BackendAPI BackendDB = backend.BackendDB BackendAuto = backend.BackendAuto )
Backend mode constants define how commands fetch data.
BackendAPI: Commands fetch data exclusively from the Beeper Desktop API. If the API is unavailable, commands fail with an error.
BackendDB: Commands fetch data exclusively from the local SQLite database. This mode works offline but data may be stale (last synced when Beeper Desktop was running). Some features are not available in DB mode (pagination, muted/pinned filters, etc.).
BackendAuto (default): Commands try the API first, then automatically fall back to the local database if:
- The API client cannot be created (network issues, API unavailable)
- The API call returns an error
- The API returns empty results
Fallback only occurs when the query can be satisfied by the DB. Commands with API-only features (pagination cursor, direction, inbox filter, etc.) disable fallback automatically.
When fallback occurs, a message is printed to stderr indicating the reason and that DB data is being used. If WarnStale is enabled on the FallbackOptions, an additional warning notes that data may be stale.
Variables ¶
var ( Version = "dev" Commit = "unknown" BuildDate = "unknown" )
These are set via ldflags during build
Functions ¶
func NewRootCmd ¶
func OutputList ¶ added in v0.1.7
Types ¶
type App ¶ added in v0.1.7
func AppFromContext ¶ added in v0.1.7
func (*App) AccountIDList ¶ added in v0.2.5
func (*App) AccountParams ¶ added in v0.1.7
func (*App) AddAccountIDs ¶ added in v0.1.7
func (*App) AgentHandlesEnabled ¶ added in v0.2.5
func (*App) IsTextLikeOutput ¶ added in v0.2.3
func (*App) OutputEvent ¶ added in v0.1.7
func (*App) OutputTextf ¶ added in v0.1.7
func (*App) ProgressWriter ¶ added in v0.1.7
ProgressWriter returns stderr when JSON output is requested to keep stdout clean.
func (*App) RecordChatHandles ¶ added in v0.2.5
func (*App) RecordContactHandles ¶ added in v0.2.5
func (*App) RecordInboxHandles ¶ added in v0.2.5
func (*App) RecordMessageHandles ¶ added in v0.2.5
func (*App) ResolveAlias ¶ added in v0.2.1
func (*App) ResolveChatByName ¶ added in v0.1.7
func (*App) ResolveChatHandle ¶ added in v0.2.5
func (*App) ResolveChatIDFromArgOrFlag ¶ added in v0.1.7
func (*App) ResolveChatIDFromFlags ¶ added in v0.1.7
func (*App) ResolveMessageHandle ¶ added in v0.2.5
Source Files
¶
- accounts.go
- agent.go
- agent_helpers.go
- agent_smoke.go
- agent_state.go
- agent_tools.go
- alias.go
- app.go
- auth.go
- backend.go
- chats.go
- client.go
- clock.go
- completion.go
- completions.go
- config.go
- contacts.go
- db_helpers.go
- doctor.go
- examples.go
- filters.go
- focus.go
- handles_cmd.go
- inbox.go
- inbox_db.go
- limits.go
- messages.go
- messages_db.go
- output.go
- output_messages.go
- profiles.go
- reminders.go
- root.go
- schema.go
- time_parse.go
- trace.go
- validate.go
- version.go