logs
- Repo stars 330
- License MIT
- Author repo claude-skill-registry
- Domain
- Data
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @majiayu000 · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Shella Logs
View daemon and plugin logs from `~/.local/state/shella/dev.log`.
## Arguments
- `$ARGUMENTS` may contain:
- A plugin name to filter by (e.g., "agent", "terminal")
- A number of lines to show (default: 50)
- "all" to show more lines
- "errors" or "error" to filter to errors/warnings only
## Log File Location
```
~/.local/state/shella/dev.log
```
Each line is JSON with fields: `time`, `level`, `prefix`, `msg`, and optional data fields.
## Commands
**Recent logs (last 50 lines)**:
```bash
tail -50 ~/.local/state/shella/dev.log
```
**Filter by plugin** (prefix field contains plugin name):
```bash
grep '"prefix":"agent' ~/.local/state/shella/dev.log | tail -50
```
**Errors only**:
```bash
grep '"level":"error"' ~/.local/state/shella/dev.log | tail -50
```
**Parse and format** for readability - extract time, prefix, level, msg:
```bash
tail -50 ~/.local/state/shella/dev.log | while read line; do
echo "$line" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); print(f'{d.get(\"prefix\",\"daemon\"):20} {d.get(\"level\",\"info\"):5} {d.get(\"msg\",\"\")}')" 2>/dev/null || echo "$line"
done
```
## Output
Present logs in a readable format. For JSON lines, extract the key fields (timestamp, prefix, level, message). Highlight errors in your response.
If the log file doesn't exist, tell the user the daemon hasn't been run yet or logs are empty.
Sections and files
Listed in source order.
sections -> Arguments → Log File Location → Commands → Output
terms -> Recent logs (last 50 lines) · Filter by plugin · Errors only · Parse and format
files/cmd -> ~/.local/state/shella/dev.log · $ARGUMENTS · time · level · prefix · msg
body sha256 -> bcce1b986a14
Arguments
$ARGUMENTSmay contain: A plugin name to filter by (e.g., "agent", "terminal") A number of lines to show (default: 50) "all" to show more lines "errors" or "error" to filter to errors/warnings onlyLog File Location
Each line is JSON with fields:
time,level,prefix,msg, and optional data fields.Commands
Recent logs (last 50 lines): Filter by plugin (prefix field contains plugin name): Errors only: Parse and format for readability - extract time, prefix, level, msg:
Output
Present logs in a readable format. For JSON lines, extract the key fields (timestamp, prefix, level, message). Highlight errors in your response. If the log file doesn't exist, tell the user the daemon hasn't been run yet or logs are empty.