mitoxide-agent 0.1.0

Remote agent binary for Mitoxide
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# Mitoxide Agent


[![Crates.io](https://img.shields.io/crates/v/mitoxide-agent.svg)](https://crates.io/crates/mitoxide-agent)
[![Documentation](https://docs.rs/mitoxide-agent/badge.svg)](https://docs.rs/mitoxide-agent)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Remote agent binary for Mitoxide - the lightweight agent that runs on remote systems to execute commands and manage resources.

## Features


- Self-bootstrapping agent deployment
- Multi-platform support (Linux, macOS, Windows)
- Privilege escalation handling
- PTY operations for interactive commands
- Resource constraint handling
- WASM module execution support

## Installation


Install the agent binary:

```bash
cargo install mitoxide-agent
```

## Usage


The agent is typically deployed automatically by Mitoxide, but can be run manually:

```bash
# Run agent with default settings

mitoxide-agent

# Run with custom configuration

mitoxide-agent --config /path/to/config.json

# Run in debug mode

RUST_LOG=debug mitoxide-agent
```

## Configuration


The agent can be configured via environment variables or configuration file:

```json
{
  "max_memory": "512MB",
  "max_cpu_time": "30s",
  "allowed_commands": ["*"],
  "wasm_enabled": true,
  "sudo_enabled": false
}
```

## Security


The agent includes several security features:
- Command allowlist/blocklist
- Resource limits (memory, CPU, disk)
- Privilege escalation controls
- Sandboxed WASM execution

## Documentation


- [API Documentation](https://docs.rs/mitoxide-agent)
- [Main Mitoxide Documentation](https://docs.rs/mitoxide)
- [GitHub Repository](https://github.com/yourusername/mitoxide)

## License


This project is licensed under the MIT License.