Skip to content

Handle shell quoting

If your topic contains $, backticks, or other special characters, wrap it in quotes to prevent your shell from interpreting them.

Use single quotes to prevent shell expansion:

Terminal window
council convene 'Should we raise salaries to $180K?'

Or escape individual characters:

Terminal window
council convene "Should we raise salaries to \$180K?"

Use single quotes or escape with backtick:

Terminal window
# Single quotes (safest)
council convene 'Should we raise salaries to $180K?'
# Backtick escape
council convene "Should we raise salaries to `$180K?"

To sidestep shell quoting entirely, write your topic to a file and pass it via --prompt-file:

Terminal window
echo "Should we raise salaries to $180K?" > topic.txt
council convene --prompt-file topic.txt

Or pipe from stdin:

Terminal window
echo "Should we raise salaries to $180K?" | council convene --prompt-file -

The file bypasses the shell, so $180K, backticks, and $variables survive exactly as written.

CharacterBash/ZshPowerShellIn file (--prompt-file)
$'...' or \$'...' or `$Already safe
Backtick'...' or \`Already escapedAlready safe
!'...' or \!Already safeAlready safe
*'...' or \*'...'Already safe

When a topic looks like it may have been mangled by the shell (for example, a $amount that expanded to nothing), Council echoes what it received and asks for confirmation before proceeding.