https://github.com/candidosales/wp-agent-tool
🦀🪛 WordPress Agent Tool
https://github.com/candidosales/wp-agent-tool
agent cli diagnostic-tool rust wordpress
Last synced: 3 months ago
JSON representation
🦀🪛 WordPress Agent Tool
- Host: GitHub
- URL: https://github.com/candidosales/wp-agent-tool
- Owner: candidosales
- Created: 2026-01-31T13:57:09.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-12T22:34:44.000Z (5 months ago)
- Last Synced: 2026-02-13T07:41:06.410Z (5 months ago)
- Topics: agent, cli, diagnostic-tool, rust, wordpress
- Language: Rust
- Homepage:
- Size: 9.94 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# WP Agent
A Rust-based CLI tool for comprehensive WordPress diagnostics and maintenance.
WP Agent automates common WordPress maintenance checks, helping you identify potential issues with your site setup quickly and efficiently.
## Features
- **Automatic WP-CLI management**: Detects and installs WP-CLI if needed
- **Smart root detection**: Automatically finds your WordPress installation
- **Root execution support**: Handles execution as root seamlessly
- **Comprehensive diagnostics**:
- Database integrity and optimization checks
- Plugin updates and security audits
- PHP version and system resource monitoring
- Network connectivity verification
- Security checksums and debug mode detection
- Performance analysis (object cache, autoloaded options, cron)
- Maintenance checks (revisions, transients, debug logs)
- **Color-coded reports**: Easy-to-read summary with OK/WARNING/ERROR indicators
## Documentation
- [Quickstart](#quickstart)
- [Installation](./docs/installation.md)
- [Basic Usage](./docs/basic-usage.md)
- [Features](./docs/features.md)
- [Creating Releases](./docs/creating-releases.md)
## Quickstart
Install WP Agent with a single command:
```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/candidosales/wp-agent-tool/releases/latest/download/install.sh | sh
```
Then navigate to your WordPress directory and run:
```bash
wp-agent
```
The tool will automatically:
1. Check for WP-CLI (and install it if needed)
2. Locate your WordPress root
3. Run comprehensive diagnostics
4. Display a summary report
For more installation options, see the [Installation Guide](./docs/installation.md).
## Prerequisites
- **Unix-like Environment**: Tested on macOS and Linux
- **WP-CLI** (Optional): The tool can install a local copy if not found
## Development
### Project structure
```
src/
├── main.rs # Entry point and orchestration
├── cli.rs # Command-line interface
├── wp.rs # WP-CLI wrapper
├── report.rs # Report generation and display
└── diagnosis/ # Diagnostic modules
├── database.rs
├── plugins.rs
├── system.rs
├── network.rs
├── security.rs
├── performance.rs
└── maintenance.rs
```
### Building from source
```bash
# Clone the repository
git clone https://github.com/candidosales/wp-agent-tool
cd wp-agent-tool
# Build the release binary
cargo build --release
# Run tests
cargo test
# The binary will be at target/release/wp-agent
```
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development guidelines.
## License
[MIT](./LICENSE)
## Contributing
Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.