11 releases
Uses new Rust 2024
new 0.1.63 | May 4, 2025 |
---|---|
0.1.62 | May 4, 2025 |
0.1.60 | Apr 22, 2025 |
0.1.4 | Mar 28, 2025 |
#84 in Machine learning
369 downloads per month
62KB
1K
SLoC
You - Your Optimized UNIX (and Windows too)
English | 中文
you
is a command-line tool that translates natural language instructions into executable shell commands, making command-line operations more accessible and intuitive. It's designed especially for newcomers to command-line interfaces, but also helps experienced users by reducing cognitive load and documentation searches.
Core Features
- Talk in Plain Language: Just tell the tool what you want to do in regular words, and it turns that into commands the computer understands
- Chat Mode: Have a back-and-forth conversation where you can ask for multiple things while the tool remembers what you talked about before
- Command Review: The tool handles the hard technical stuff but lets you decide when to run commands
- Save for Later: Keep useful commands to use again without having to ask the tool each time
Installation
Setup Script (Linux & macOS)
Download and run the setup script:
curl -O https://raw.githubusercontent.com/AspadaX/you/main/setup.sh && chmod +x ./setup.sh && ./setup.sh && rm ./setup.sh
To uninstall:
curl -O https://raw.githubusercontent.com/AspadaX/you/main/uninstall.sh && chmod +x ./uninstall.sh && ./uninstall.sh && rm ./uninstall.sh
Using Cargo
If you have Rust installed:
cargo install you
Usage
Basic Command Execution
Run a command described in natural language:
you run "find the largest file in my downloads directory"
Command Explanation
Get an explanation of what a command does:
you explain "find . -type f -name '*.txt' -size +10M"
Interactive Mode
Start a conversational session to run multiple related commands:
you run
Other Examples
# Find files you've modified in the last week
you run "show me files I've modified in the last 7 days"
# Get system information
you run "how many CPU cores and how much RAM does this system have?"
# Complex tasks made simple
you run "compress all JPG images in the current directory and save them to a new folder"
# Remote operations
you run "connect to my server at 192.168.*.* and check disk space"
LLM Support
you
works with various LLMs:
- Works well with small models like
smollm2
(including the 135m version) - Compatible with
ollama
for using any open-source model for free - Configure your preferred model for the best balance of performance and accuracy
Workflow
- Type your request in natural language
- Review the suggested command(s) and explanation
- Type 'y' to execute or provide additional guidance
- If there's an error, the AI automatically suggests a corrected command
- Optionally save useful command sequences for future reuse
Why Use You?
- Reduce Documentation Searches: Get the right command without extensive searching
- Learning Tool: See how natural language translates to actual commands
- Productivity Boost: Accomplish complex tasks with simple instructions
- Safe Command Execution: Review commands before execution
- Error Recovery: Get help when commands fail
- Context Retention: In interactive mode, the AI remembers previous commands
License
MIT
Credits
Created by Xinyu Bao
Acknowledgments
This project would not be possible without these amazing libraries:
- anyhow: Error handling made simple and flexible
- async-openai: API client for interacting with OpenAI's language models
- cchain: Command chaining functionality for shell operations
- chrono: Date and time handling with precision
- clap: Command-line argument parsing with a beautiful interface
- console: Terminal text styling and utilities
- indicatif: Progress indicators for command-line applications
- serde/serde_json: Powerful serialization and deserialization framework
- sysinfo: System information gathering across platforms
- tokio: Asynchronous runtime for efficient operations
A big thank you to all the developers who maintain these open-source libraries!
you
- because command lines should understand you, not the other way around.
Dependencies
~32–50MB
~1M SLoC