Back to directory

agent-stardew

In a curated listMaintenance: Active

rottenpen/agent-stardew

Registers Stardew observation and action tools, an autonomous-run panel, staged planning, and a bundled stardew skill.

View on GitHub
$ dsh plugin add agent-stardew

15

stars

2

forks

TypeScript

Language

MIT

License

2026-09-19

Created

2026-09-20

Last push

MIT, TypeScript dsh plugin + SMAPI Mod + standalone CLI that hands Stardew Valley observation and actions to the Jev autonomy loop, with an in-chat run panel and a bundled stardew skill.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-20

License

MIT

01What can it help you accomplish?

  • Hand Jev a single farm goal and let it play the chores

    An autonomous run in which the controller keeps choosing and executing the next step, with a side panel showing the season calendar, farm clock, stamina bar, inventory slots and farm journal

    Stardew Valley players who want a DeepSeek Harness agent to do routine farm work while they watch the decisions

  • Stage-plan a complex farm goal inside dsh chat

    Staged execution — Jev runs each stage, returns stage results and blocked evidence to the same chat, and later stages share the budget

    Users who plan with a chat model on top of dsh (e.g. plant 5 parsnips, water them, then go home and sleep)

  • Check whether the job actually finished, instead of trusting the agent

    Completion conditions checked against game state — crop ID 24, count 1, watered — reported as verified or as “needs your review” when a free-form goal ends

    Users who need evidence, not narration, before calling a run done

02How to install into DeepSeek Harness

Prerequisites

  • Node.js 22+ and the pnpm version the repository pins
  • A compatible dsh — the README says it is currently verified against `0.1.5-rc.1`
  • For real play only: Stardew Valley, SMAPI and the .NET 6 SDK (compile baseline is macOS, Stardew Valley 1.6.15, SMAPI 4.5.2)

Installation steps

  1. 01

    Install dependencies: `corepack enable`, then `pnpm install --frozen-lockfile`

  2. 02

    Put `OPENROUTER_API_KEY` into the project `.env`, then start the mock farm with `pnpm start --mock --jev` (or `pnpm run setup --mock` + `pnpm dev --mock` for a self-contained `work/dsh/` environment)

  3. 03

    Follow the browser login entry that opens — reopen it later with `pnpm open`, or run `pnpm open --print` for a fresh link when switching browsers or using a private window

  4. 04

    In dsh chat click “农场小助手” at the top right to expand the panel, click “观察”, type the goal and click “开始农活”

  5. 05

    For the real game: quit the game normally, then run `pnpm start --jev` — it builds, backs up and installs the Mod and starts SMAPI plus dsh; a custom install path goes through `--game-path "/…/Contents/MacOS"`

Verify the integration

  • `pnpm check` — type checking, build, protocol, CLI and mock farming tests; the README states this base check needs neither the game nor a model key
  • `pnpm test:dsh` — exercises the real dsh tool registrar, build artifacts, CLI subprocess and cancellation without calling a model

03DSH integration and capability boundaries

DSH integrationNative runtime

Native dsh plugin: the dsh plugin hosts the Jev autonomy loop and the in-chat farm panel, while a SMAPI Mod and a standalone CLI supply the in-game observation and actions.

  • Farm run panel inside dsh chat

    game observation coming from the Mod and CLI→A right-side panel with season calendar, farm clock, stamina bar, inventory slots and farm journal, plus pause / resume / stop controls and a decision detail view

    pausing the agent does not pause in-game time
  • Jev autonomy controller

    Autonomous runs, dynamic candidates, single-step execution, pause / resume / stop, run records and result verification

    writes run records that stay on the local machine
  • Staged planning for complex goals

    Per-stage execution with results and blocked evidence returned to the originating chat

    later stages share the same budget as earlier stages
  • Bundled `stardew` skill

    Auto-registered when the dsh plugin is installed — no extra install — covering simple-goal startup, staged complex goals, pause and takeover, evidence review and blocked handling

  • Mock farm for keyless dry runs

    `pnpm start --mock --jev` or `pnpm dev --mock`→A simulated farm with the dsh Web UI; results are explicitly labelled `mock`

04Who is it for? When not to use it?

Good for

  • Stardew Valley players who want a DeepSeek Harness agent to do routine farm work while they watch the decisions
  • Users who plan with a chat model on top of dsh (e.g. plant 5 parsnips, water them, then go home and sleep)
  • Users who need evidence, not narration, before calling a run done

Not for

  • This is an operable development build: full real-game farm work and the autonomous capability-acquisition acceptance are still pending, so results are not a finished product claim.
  • The Mod is compiled against macOS, Stardew Valley 1.6.15 and SMAPI 4.5.2, needs the .NET 6 SDK, and the game has to be closed when the Mod is installed; only exploration, movement, farming, scene interaction and dialogue are wired up so far — shop purchases and container transfers still need base interfaces.
  • Jev autonomy calls models through an `OPENROUTER_API_KEY` in the project `.env`, while the chat entry point configures its model separately; the panel itself needs no chat model.

05Compatibility, maintenance and safety notes

  • This is an operable development build: full real-game farm work and the autonomous capability-acquisition acceptance are still pending, so results are not a finished product claim.
  • The Mod is compiled against macOS, Stardew Valley 1.6.15 and SMAPI 4.5.2, needs the .NET 6 SDK, and the game has to be closed when the Mod is installed; only exploration, movement, farming, scene interaction and dialogue are wired up so far — shop purchases and container transfers still need base interfaces.
  • Jev autonomy calls models through an `OPENROUTER_API_KEY` in the project `.env`, while the chat entry point configures its model separately; the panel itself needs no chat model.
  • Unofficial community tool: you must install Stardew Valley and SMAPI yourself. The repo ships no game, assets or saves, and real-game verification uses a dedicated save plus backups instead of your existing save.
2026-09-192026-09-20Not specified by the author

MIT · early development build (no tagged release yet, last push 2026-09-20)

06Frequently asked questions

Do I need the actual game to try agent-stardew?

No. The README starts with `pnpm start --mock --jev`, a mock farm, and says the base checks need neither the game nor a model key; mock results are explicitly labelled `mock`. Real play needs Stardew Valley, SMAPI and the .NET 6 SDK, with the game closed while the Mod is installed.

Which model does it use?

Three separate things: Jev autonomy reads `OPENROUTER_API_KEY` from the project `.env`; the chat entry point configures its model on its own; and the panel does not need a chat model at all — “点击观察,输入目标并点击开始农活” works without one.

How do I get the run panel open?

Click “农场小助手” at the top right of dsh chat and the right-side panel expands; the task card’s “查看农场” opens the same panel, and it can also be opened directly at the panel URL the README gives. Reopen a login entry with `pnpm open`, or `pnpm open --print` when the link expired or the service reconnected.

How do I know a run really finished?

Fill in completion conditions — crop ID `24`, count `1`, watered — and the controller accepts against game state; a verified run is marked “已核验完成”, while a free-form goal that Jev decides to end is only “待你复核” and must not be treated as verified. Note that pausing the agent does not pause in-game time.

Is this an official Stardew Valley tool?

No — it is an unofficial community project under the MIT license, and you install Stardew Valley and SMAPI yourself; the repo distributes no game, assets or user saves. It is also still a development build with no tagged release: full real-game farm work and the autonomous capability-acquisition acceptance are pending.

08Data and sources

  • Author-claimedgithub.comd1f8934351a0…

    基于 Jev 的星露谷 Agent。SMAPI Mod 与独立 CLI 提供游戏观察和动作,dsh 插件承载自主控制循环与运行面板。用户给一次目标,Jev 持续选择并执行下一步。

  • Author-claimedgithub.comd1f8934351a0…

    在 dsh 聊天右上角点击“农场小助手”,即可展开右侧面板;任务卡片中的“查看农场”打开同一个面板。

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-20. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.