nyra 0.1.1

Network Yield Runtime Assistant : system assistant for process control and monitoring.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

# Nyra


NYRA — Network Yield Runtime Assistant : System assistant for process control and monitoring.

It provides a single, unified interface for interacting with processes on Linux: 

    -   launching programs
    -   listing running tasks 
    -   stopping them
    -   inspecting resource usage

While traditional Linux tools like `ps`, `kill`, and `htop` exist as separate utilities,  
Nyra focuses on *automation, consistent ergonomics,* and a *Rust-native developer interface* — making it suitable both as a command-line tool and an embeddable library.

---

## Features

| Feature | Command | Status |
|--------|---------|--------|
| Run a program | `Nyra run <program>` | ✅ Working |
| List running processes | `Nyra list` | ✅ Working |
| Stop a process (SIGTERM) | `Nyra stop <pid>` | ✅ Working |
| Get process resource usage (CPU + memory) | `Nyra stats <pid>` | ✅ Working |

---

### Examples

- Start a program:

```
Nyra run firefox
```

- View running processes:

```
Nyra list
```

- Stop a process:

```
Nyra stop 2173
```

- Check usage stats:

```
Nyra stats 2173
```

---

<!-- ## Roadmap

Nyra is under active development.  
Planned upcoming features:

### Supervision Mode
- Automatically restart a process if it exits:

```
nyra supervise firefox
```

### Sandboxed Execution
- Run untrusted programs with restricted system access:

```
nyra sandbox run "python script.py"
```

### Live Top Mode
Real-time terminal dashboard similar to `htop`:

```
nyra top
```

### Force Stop
Provide a SIGKILL fallback when SIGTERM is ignored:

``` -->
nyra stop <pid> --force
```

---

## 🎯 Vision

Linux provides powerful primitives — signals, `/proc`, namespaces, cgroups —  
but they are fragmented across many command-line tools and scripting interfaces.

Nyra aims to unify these capabilities into:

- one consistent CLI
- one stable Rust API
- one programmable automation layer

It is designed for:

- DevOps automation
- Sandboxing and experimentation
- Process supervision and local orchestration
- Systems research and education
- Embedded and developer tooling

Nyra is *not* trying to replace Linux tooling —  
it is giving those tools a **programmable, ergonomic, and portable interface.**

---

## 🛠️ Installation (local)

```
cargo build --release
sudo cp target/release/Nyra/usr/local/bin/
```

Then run:

```
nyra list
```

---

## License

MIT 

---

## Contributing

Issues, feature proposals, PRs, and discussion are welcome.