{"id":49037916,"url":"https://github.com/yogasw/wick","last_synced_at":"2026-06-14T12:01:15.626Z","repository":{"id":352367740,"uuid":"1212953848","full_name":"yogasw/wick","owner":"yogasw","description":"Build internal tools and AI agents in Go — or just download and run Claude / Codex / Gemini as a Slack + Telegram + web agent host. No copy-pasting. You own the code.","archived":false,"fork":false,"pushed_at":"2026-06-12T03:14:29.000Z","size":17580,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-12T04:22:35.003Z","etag":null,"topics":["ai","ai-agent","ai-tools","low-code","n8n"],"latest_commit_sha":null,"homepage":"http://yogasw.github.io/wick/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yogasw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-16T22:39:15.000Z","updated_at":"2026-06-12T03:53:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yogasw/wick","commit_stats":null,"previous_names":["yogasw/wick"],"tags_count":120,"template":false,"template_full_name":null,"purl":"pkg:github/yogasw/wick","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yogasw%2Fwick","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yogasw%2Fwick/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yogasw%2Fwick/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yogasw%2Fwick/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yogasw","download_url":"https://codeload.github.com/yogasw/wick/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yogasw%2Fwick/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34320273,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agent","ai-tools","low-code","n8n"],"created_at":"2026-04-19T13:05:15.395Z","updated_at":"2026-06-14T12:01:15.579Z","avatar_url":"https://github.com/yogasw.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wick\n\n\u003e **Build internal tools and AI agents in Go — or just download and run Claude / Codex / Gemini as a Slack + Telegram + web agent host. No copy-pasting. You own the code.**\n\nTwo ways to use wick:\n\n---\n\n## 1. Run AI Agents — no Go, no framework\n\nWant Claude / Codex / Gemini as a Slack bot, Telegram bot, or web assistant? Just download the binary.\n\n```bash\n# Linux / macOS / Termux — auto-detects OS + arch\ncurl -fsSL https://yogasw.github.io/wick/install.sh | sh\nwick-agent server   # web UI at http://localhost:9425 — creds auto-generated on first run\n```\n\n```powershell\n# Windows\niwr -useb https://yogasw.github.io/wick/install.ps1 | iex\n```\n\n```bash\n# Docker — single-container: HTTP + cron in one process\ndocker run -d \\\n  -p 9425:9425 \\\n  -v wick-agent-data:/root/.wick-agent \\\n  ghcr.io/yogasw/wick-agent:latest all\n```\n\nThe binary supports two modes — pick one:\n\n| Mode | Command | Best for |\n|---|---|---|\n| **System tray** | `wick-agent` (no args) | Desktop — right-click menu, icon shows state, auto-start on login |\n| **Headless** | `wick-agent server` | Remote server / Docker — no GUI, logs to stdout |\n\nThen in the web UI (`/tools/agents`):\n\n1. **Providers** — point wick-agent at your Claude / Codex / Gemini binary and your PAT\n2. **Channels** — connect Slack (Socket Mode), Telegram bot, or just use the built-in Web UI\n3. **Workspaces** — pick a folder for the agent to work in (a `default` is created automatically)\n4. Send a message → wick-agent spawns the agent and routes the conversation\n\nEvery Bash command the agent runs goes through the **Command Gate** — whitelist globs or escalate to interactive 4-mode approval (Approve once / This session / Always / Block), audited to JSONL.\n\n→ [Agent host docs](https://yogasw.github.io/wick/guide/agents-only)\n\n---\n\n## 2. Build Internal Tools \u0026 Jobs — AI writes real Go files\n\n```bash\n# Install wick CLI (needs Go installed)\ngo install github.com/yogasw/wick@latest\n\nwick init my-app\ncd my-app\nwick dev   # http://localhost:9425\n```\n\n\u003e The `install.sh` / `install.ps1` scripts above install `wick-agent` (the runtime binary), **not** the `wick` CLI used for scaffolding. For development you need `go install`.\n\nOpen `my-app/` in Claude Code and prompt what you need:\n\n```\nadd a tool called \"base64\" that encodes and decodes text\n```\n\n```\nadd a background job that syncs data from our API every 30 minutes\n```\n\n```\nadd a connector for GitHub with list_repos and create_issue operations\n```\n\nClaude writes real Go files in your repo — you own everything. `git diff` to review, `git revert` to undo.\n\n### What wick scaffolds\n\n```\nmy-app/\n├── main.go          # register tools, jobs, and connectors here\n├── AGENTS.md        # Claude reads this — framework conventions\n├── .claude/skills/  # bundled AI skills (tool-module, job-module, connector-module)\n├── wick.yml         # task runner config\n├── tools/\n│   ├── convert-text/   # example tool (UI page)\n│   └── external/       # external link cards\n├── jobs/\n│   └── auto-get-data/  # example background job\n├── connectors/\n│   └── crudcrud/       # example connector (LLM-facing via MCP)\n└── tags/\n    └── defaults.go     # shared tag catalog\n```\n\n### What the framework handles\n\nYou write business logic. Wick handles everything else:\n\n| You write | Wick provides |\n|---|---|\n| `func Register(r tool.Router)` | Admin UI, tag-based access, runtime config editing |\n| `func Run(ctx) (string, error)` | Cron scheduler, job history, run/retry UI |\n| `func Operations() []connector.Op` | MCP endpoint, per-call audit log, OAuth + PAT auth |\n\n### Module types\n\n| Type | Audience | Entry point | URL |\n|------|----------|-------------|-----|\n| Tool | Humans (web UI) | `Register(r tool.Router)` | `/tools/{key}` |\n| Job | Scheduler | `Run(ctx) (string, error)` | `/jobs/{key}` |\n| Connector | LLMs via MCP | `Operations()` | `/mcp` |\n| Agents | Slack / Telegram / Web | built-in | `/tools/agents` |\n\n### Common commands\n\n| Command | What it does |\n|---------|-------------|\n| `wick dev` | Generate templ + CSS, start server |\n| `wick server` | Start HTTP server only |\n| `wick worker` | Start background job worker |\n| `wick all` | HTTP + cron in one process (single-node deploys) |\n| `wick build` | Compile binary with version metadata |\n| `wick test` | Run `go test ./...` with coverage |\n| `wick skill sync` | Refresh bundled AI skills after upgrade |\n\n→ [Framework docs](https://yogasw.github.io/wick/guide/getting-started) · [AI Quickstart](https://yogasw.github.io/wick/guide/ai-quickstart)\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](docs/contributing.md) or the [Contributing guide](https://yogasw.github.io/wick/contributing).\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyogasw%2Fwick","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyogasw%2Fwick","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyogasw%2Fwick/lists"}