Document cloning: agents pull the repo instead of copying files

This commit is contained in:
oc
2026-08-12 13:10:12 -07:00
parent 2a73f2ef5e
commit 712d9c0dff
2 changed files with 24 additions and 6 deletions
+17 -6
View File
@@ -17,11 +17,19 @@ You are `<AGENT_NAME>`. Give yourself working access to Vikunja at
### Facts you need
- Tooling lives at `/srv/pods/vikunja-agents/` on `reptar`: `vk` (CLI),
`vkclient.py` (shared client), `vikunja_mcp.py` (MCP server, stdio).
Standard-library Python only — no virtualenv, no pip install.
- If you are **not** on `reptar`, copy those three files to the machine you run
on (`~/opt/vikunja-agents/`) and symlink `vk` onto your `PATH`.
- The tooling is a public repo. Clone it on whatever machine you run on — no
credentials needed, and standard-library Python only, so there is nothing to
install:
```sh
git clone https://git.dominat.us/oc/vikunja-agents.git ~/opt/vikunja-agents
mkdir -p ~/.local/bin && ln -sf ~/opt/vikunja-agents/vk ~/.local/bin/vk
```
It gives you `vk` (CLI), `vikunja_mcp.py` (MCP server, stdio) and
`vkclient.py` (shared client). To update later: `git -C ~/opt/vikunja-agents pull`.
- On `reptar` it is already checked out at `/srv/pods/vikunja-agents/`; use that
path instead of cloning again.
- Auth is a Vikunja **API token**, read from `~/.config/vikunja-agents/config.json`
(mode 0600) or `$VIKUNJA_TOKEN`. Select an identity with `$VIKUNJA_PROFILE`.
- Your account must already exist. The normal shape is a **bot user**: a local
@@ -97,7 +105,10 @@ mcp:
```
`other` — the server speaks MCP over stdio (JSON-RPC 2.0, newline-delimited).
Run `/srv/pods/vikunja-agents/vikunja_mcp.py` with `VIKUNJA_PROFILE` set. If your
Run `vikunja_mcp.py` with `VIKUNJA_PROFILE` set.
In every snippet above, use `/srv/pods/vikunja-agents/vikunja_mcp.py` on `reptar`
and `~/opt/vikunja-agents/vikunja_mcp.py` wherever you cloned it. If your
harness cannot speak MCP, skip this step and use the `vk` CLI instead; it covers
the same ground.