Repository navigation
docs: Recurring runs section (platform guides) - #19
Conversation
Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
github-actions
Bot
added
the
documentation
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
| _Weekly rebuild of graph.db so downstream tools see fresh linkage._ | ||
|
|
||
| ```cron | ||
| 0 6 * * 0 devin-graph build |
There was a problem hiding this comment.
🔴 Cron cannot find the installed CLI
With the documented uv install, cron runs devin-graph build without the CLI's directory on PATH. Cron does not load the shell configuration used by the PATH instructions, so the weekly rebuild never runs.
Learn more
The Linux guide installs the command with uv tool install and identifies ~/.local/bin as its executable directory in the PATH instructions. User cron entries normally receive a minimal PATH and do not source .bashrc or .zshrc, even when the command works in an interactive terminal. The cron line therefore cannot locate devin-graph under the documented setup.
Example: Ada adds export PATH="$HOME/.local/bin:$PATH" to .bashrc and can run devin-graph build in her terminal. At Sunday 06:00, cron runs without that PATH setting, reports devin-graph: not found, and leaves the graph unchanged.
Recommended fix: Use the installed CLI's absolute executable path in the cron entry, or define a suitable PATH explicitly in the crontab. Also pass an absolute --graph path so the scheduled rebuild updates the intended database.
Was this helpful? React with 👍 or 👎 to provide feedback.
| _Weekly rebuild of graph.db so downstream tools see fresh linkage._ | ||
|
|
||
| ```powershell | ||
| schtasks /create /tn "devin-graph" /tr "devin-graph build" /sc daily /st 04:00 /f |
There was a problem hiding this comment.
🔍 Weekly description conflicts with daily schedule
Both Windows guides promise weekly rebuilds, but their schtasks examples schedule daily runs. Align the description and schedule.
Was this helpful? React with 👍 or 👎 to provide feedback.
| schtasks /create /tn "devin-graph" /tr "devin-graph build" /sc daily /st 04:00 /f | ||
| ``` | ||
|
|
||
| User-scope `schtasks` needs no admin. If Group Policy disables Task Scheduler, run the command manually or use the tool's own `install` subcommand where available. |
There was a problem hiding this comment.
🔍 Unavailable install fallback in corporate guide
The suggested install fallback does not exist in devin-graph's CLI. Only manual runs remain when Task Scheduler is disabled.
Was this helpful? React with 👍 or 👎 to provide feedback.
| _Weekly rebuild of graph.db so downstream tools see fresh linkage._ | ||
|
|
||
| ```powershell | ||
| schtasks /create /tn "devin-graph" /tr "devin-graph build" /sc daily /st 04:00 /f |
There was a problem hiding this comment.
🔍 Uninstall instructions omit scheduled task cleanup
The new task survives uv tool uninstall devin-graph, but uninstall guidance says no scheduled tasks remain. Add removal instructions for users who enable recurring runs.
Was this helpful? React with 👍 or 👎 to provide feedback.
|
|
||
| ## Recurring runs (optional) | ||
|
|
||
| _Weekly rebuild of graph.db so downstream tools see fresh linkage._ |
There was a problem hiding this comment.
🔍 Shared rebuild guidance duplicated across guides
The rebuild purpose appears in all three platform guides. Platform-doc rules place shared behavior in README.md and OS-specific scheduling commands here.
Was this helpful? React with 👍 or 👎 to provide feedback.
| - **Permissions:** tools read Devin data under `$XDG_DATA_HOME/devin` and write only their own config/state — no root or sudo is required. | ||
| - **Scheduling:** optional recurring work belongs to `systemd --user` timers or cron; installation never creates jobs. | ||
|
|
||
| ## Recurring runs (optional) |
There was a problem hiding this comment.
🔍 Changelog omitted for new scheduling instructions
The PR adds recurring-run instructions without updating CHANGELOG.md, despite the contribution checklist.
Was this helpful? React with 👍 or 👎 to provide feedback.
Regenerated by migrate_platform_docs.py from devin-powerups#60.
Generated with Devin