https://github.com/interwebologist/skunkagent
Work In Progress - Skunk agent is a personal AI assistant with defenses.
https://github.com/interwebologist/skunkagent
ai artificial-intelligence personal-assistant
Last synced: about 1 month ago
JSON representation
Work In Progress - Skunk agent is a personal AI assistant with defenses.
- Host: GitHub
- URL: https://github.com/interwebologist/skunkagent
- Owner: interwebologist
- Created: 2026-04-20T03:06:17.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-03T12:24:43.000Z (about 2 months ago)
- Last Synced: 2026-05-03T13:14:30.941Z (about 2 months ago)
- Topics: ai, artificial-intelligence, personal-assistant
- Language: Python
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Skunk Agent - Agent with Defenses
## Project Focus
These may or may not end up being features in the end product, at this point these are just ideas. I will build a around security products that are better or not needed and add only what is needed be added to the agent though I want this to deploy "secure"
#### Normal Agent Stuff
- add all agent stuff here. memory, web search
#### Isolation & Sandboxing
- **Shadow Git Checkpointing**
- **Hardware-Isolated MicroVMs / Token proxies**
- **Unikernel Image**
- **Network Sandboxing with Egress Proxy and HITP**
- **HITP**
- **network / command whitelisting**
#### Content & Execution Guardrails
- **Input Guardrails**:
- **Output Guardrails**:
- **Agent Lifecycle & Resource Control**:
#### Authentication & Authorization
- **Ephemeral Secrets, indentity**
## Development with Agent Sandbox
### Build Docker Image
```bash
docker build -t skunkagent .
```
### Run Agent in Sandbox with GitHub Token
```bash
docker run -it -e GITHUB_TOKEN=${GITHUB_AGENT1_TOKEN} skunkagent
```
The container will:
1. Start and provide a shell prompt
2. Have opencode CLI available (run `opencode --version` to verify)
3. Have git installed and configured to use the GITHUB_TOKEN for authentication
4. Have vim and tmux installed for editing and terminal multiplexing
5. Automatically set up git credentials when GITHUB_TOKEN is provided
*Note: The Dockerfile includes git, vim, tmux installation and automatic GitHub token configuration for HTTP endpoints. The agent will automatically use the GITHUB_TOKEN environment variable for git operations requiring authentication.*