otty / apps
All apps/gmailctl

gmailctl

gmailctl

This utility helps you generate and maintain Gmail filters in a declarative way.

Runs as gmailctl|macOS, Linux, Windows|github.com
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 12 fields

Compare, edit or apply a gmailctl configuration. Init, download, export and test are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui gmailctl
Manage Gmail filtersExample values, fixed in this page — nothing here reaches a terminal
Basic
Config directory
directory
ParametersOnly these flags are editable in the form
Config directory
Directory holding gmailctl config; defaults to the per-user location.
path
--config

gmailctl diff

Show diff

Compare the local configuration with the Gmail settings.

Show diffExample values, fixed in this page — nothing here reaches a terminal
Basic
Config file
file
Debug output
--debug
Diff context lines
integer
TasksEach one presets the form for one job
Show diff
filenamedebugcontext
ParametersOnly these flags are editable in the form
Config file
path
--filename-f
Debug output
boolean
--debug
Diff context lines
integer
--context

gmailctl apply

Apply configuration

Apply a configuration file to Gmail settings.

Apply configurationExample values, fixed in this page — nothing here reaches a terminal
Basic
Config file
file
Skip confirmation
--yes
Allow removing labels
--remove-labels
Skip config tests
--yolo
Debug output
--debug
TasksEach one presets the form for one job
Apply configuration
filenameyesremove_labelsyolodebug
ParametersOnly these flags are editable in the form
Config file
path
--filename-f
Skip confirmation
boolean
--yes-y
Allow removing labels
boolean
--remove-labels-r
Skip config tests
boolean
--yolo
Debug output
boolean
--debug

gmailctl edit

Edit and apply

Edit the configuration and apply it to Gmail.

Edit and applyExample values, fixed in this page — nothing here reaches a terminal
Basic
Config file
file
Skip config tests
--yolo
Debug output
--debug
TasksEach one presets the form for one job
Edit and apply
filenameyolodebug
ParametersOnly these flags are editable in the form
Config file
path
--filename-f
Skip config tests
boolean
--yolo
Debug output
boolean
--debug
SourcesEvery flag above is checked against these
readme
- Custom location: use the `--config` argument.
manual

github.com

src
diffCmd.PersistentFlags().StringVarP(&diffFilename, "filename", "f", "", "configuration file") diffCmd.PersistentFlags().BoolVar(&diffDebug, "debug", false, "print extra debugging information") diffCmd.PersistentFlags().IntVar(&diffContext, "context", papply.DefaultContextLines, "number of lines of filter diff context to show") flags: --filename -f --debug -…
help

github.com

src
applyCmd.PersistentFlags().StringVarP(&applyFilename, "filename", "f", "", "configuration file") applyCmd.Flags().BoolVarP(&applyYes, "yes", "y", false, "don't ask for confirmation, just apply") applyCmd.Flags().BoolVarP(&applyRemoveLabels, "remove-labels", "r", false, "allow removing labels") applyCmd.Flags().BoolVar(&applySkipTests, "yolo", false, "skip co…
help

github.com

src
editCmd.PersistentFlags().StringVarP(&editFilename, "filename", "f", "", "configuration file") editCmd.Flags().BoolVarP(&editSkipTests, "yolo", "", false, "skip configuration tests") editCmd.PersistentFlags().BoolVar(&editDebug, "debug", false, "print extra debugging information") flags: --filename -f --yolo --debug -f
help

github.com

Before it fills your prompt, Otty checks the installed gmailctl against its version. A form that does not match your version is not offered.