AI Mode

AI mode translates natural language into shell commands. Sign up for free to get started.

Simple Mode (?)

Start any input with ? to enter simple AI mode:

→ ?list all files modified today
⚡ find . -type f -mtime 0

The command is shown for review. Press Enter to execute, or Escape to cancel.

Agentic Mode (??)

For complex questions, use ?? to let AI investigate:

→ ??what's using the most disk space

The AI will:

1. Run diagnostic commands (like du, df)
2. Analyze the output
3. Provide a comprehensive answer

Agentic mode requires a paid subscription (Lite, Pro, or Power).

Getting Started

# Run nosh and sign up
nosh

# You'll be prompted to enter your email
# Check your inbox for the magic link

Free users get 5,000 tokens/month for simple mode.

See Pricing for paid plans.

Examples

File Operations

→ ?find all .env files
⚡ find . -name ".env"

→ ?show disk usage by directory
⚡ du -sh */

→ ?compress the logs folder
⚡ tar -czvf logs.tar.gz logs/

Git Operations

→ ?show recent commits by author john
⚡ git log --author="john" -10

→ ?undo last commit but keep changes
⚡ git reset --soft HEAD~1

→ ?show what changed in the last week
⚡ git log --since="1 week ago" --oneline

System Information

→ ?show memory usage
⚡ free -h

→ ?list processes using most cpu
⚡ ps aux --sort=-%cpu | head -10

→ ?kill process on port 3000
⚡ lsof -ti:3000 | xargs kill

Agentic Mode Examples

→ ??why is my disk full
[AI runs: df -h, du -sh /*, finds large directories]
→ Your disk is 94% full. The largest consumers are:
  - /var/log: 12GB (old logs)
  - ~/Downloads: 8GB
  Consider running: sudo rm -rf /var/log/*.gz

→ ??is my git repo clean
[AI runs: git status, git stash list, git log origin/main..HEAD]
→ Your repo has uncommitted changes in 3 files and
  2 commits not pushed to origin/main.

Safety Features

AI-generated commands go through nosh's safety system:

• Commands are parsed and risk-assessed
• Destructive commands require confirmation
• You can allow/deny commands per-directory
• Nothing runs without your approval

Tips for Better Results

1. Be specific — "find large log files" works better than "find files"
2. Include context — "in the src directory" helps narrow results
3. Use familiar terms — Common development terminology works well

Disabling AI

If you don't want AI features, just don't sign up. nosh works perfectly as a regular shell without AI. The ? prefix will show an error prompting you to sign in.