{"slug": "show-hn-podiom-durable-sessions-scheduling-and-goals-for-local-claude-codex", "title": "Show HN: Podiom – durable sessions, scheduling and goals for local Claude/Codex", "summary": "Podiom, an open-source, local-first workspace for Claude Code and OpenAI Codex, launched on Hacker News, enabling users to give AI agents durable context, schedule work, and pursue goals over time while keeping sessions, projects, tasks, and decisions in one place. The tool shells out to native CLIs, supports autonomous goals with full access, and runs on macOS, Linux, and Windows, with mobile and Home Assistant integration.", "body_md": "**Your AI agents, in concert.**\n\nPodiom is an open-source, local-first workspace for Claude Code and OpenAI Codex. Give each agent a name and durable context, then chat, schedule work, or hand it a goal to pursue over time. Podiom keeps the sessions, projects, tasks, progress, and decisions together while the native CLIs do the work.\n\nA goal keeps the outcome, progress, and evidence in one place.\n\nClaude Code and Codex are easy to start in a terminal. They are harder to manage once you have several sessions, projects, and unattended jobs running at the same time. Context ends up spread across terminal tabs, and you spend time reconstructing what happened and what an agent should do next.\n\nPodiom puts those agents in one local workspace. Sessions stay available after the backing CLI session changes. Projects carry shared context. Roadmap tasks and schedules keep work moving. You can see which agent did the work, open the session that produced it, and continue from there.\n\nPodiom does not replace the provider runtime. It shells out to the native\n`claude`\n\nand `codex`\n\nCLIs and uses their models, MCP servers, tools, skills, and\nauthentication.\n\nA task tells an agent what to do once. A [goal](/Podiom/Podiom/blob/master/docs/goals.md) gives one lead\nagent an outcome to own over days or weeks. Describe what you want, define what\n\"done\" means, add optional metrics, and choose how often the agent should review\nits progress.\n\n- The lead agent turns the outcome into roadmap tasks and schedules, delegates work when useful, and changes the plan as it learns.\n- Each review records progress, evidence, metric changes, and the next step the agent intends to take.\n- Missing capabilities become structured access requests. Work that only you can do becomes an action item instead of disappearing into a chat transcript.\n- Every run and tool call stays attached to the goal. The agent can propose completion, but only you can mark the goal done.\n\nImportant\n\nGoals are deliberately autonomous. The lead agent and every linked task or\nschedule run with full access and without per-action approval prompts. Podiom\nrecords the resulting tool activity on the goal timeline. Read the\n[Goals guide](/Podiom/Podiom/blob/master/docs/goals.md#goals-run-in-yolo-mode) before assigning a goal.\n\nEach agent has a name, workspace, identity, provider, model, profile, permission mode, and fallback defaults. Claude and Codex agents can work side by side without flattening their provider-specific behavior.\n\nNamed agents keep their own identity, workspace, and runtime defaults.\n\nPodiom stores a canonical history for every session. If you switch provider or profile, it can replay that history onto a fresh backing CLI session. Scheduled runs and roadmap tasks create normal sessions too, so unattended work is not a dead-end log.\n\nOpen the exact session behind a task, schedule, or goal run and continue the conversation.\n\nProjects give every agent the same source context and standing instructions. The Roadmap holds assignable tasks, while the embedded scheduler handles recurring routines and timed pickups. Agent-created work keeps its provenance, so you can trace it back to the decision that created it.\n\nThe [examples cookbook](/Podiom/Podiom/blob/master/examples/README.md) has copyable schedules, a runnable\ngoal-creation script, a shared project ledger entry, agent defaults, and a\nno-credential MCP server example. Use it after onboarding when you want a real\nfirst workflow instead of a blank config file.\n\nPodiom stores its state under one configurable local root and ships the web UI\ninside `podiomd`\n\n. It runs on macOS, Linux, and Windows, and the same core can run\nas a Home Assistant add-on or in a container. Provider CLIs keep their native\nauthentication and policy controls. The native iOS and Android apps can connect\nto standalone daemons or an opt-in, API-only Home Assistant LAN endpoint; see\nthe [mobile](/Podiom/Podiom/blob/master/docs/mobile.md) and [Home Assistant](/Podiom/Podiom/blob/master/docs/home-assistant.md) guides.\n\n- Developers already using Claude Code or OpenAI Codex locally.\n- Builders who want persistent, reviewable agent work instead of disposable terminal sessions.\n- Maintainers who need recurring jobs, project context, and an audit trail in one lightweight workspace.\n- People who prefer local state and native tools over moving their workflow into another hosted agent runtime.\n\nInstall the latest release on macOS or Linux:\n\nHomebrew users can install Podiom with `brew install Podiom/podiom/podiom`\n\n.\n\n```\ncurl -fsSL https://github.com/Podiom/Podiom/releases/latest/download/install.sh | bash\n```\n\nOn Windows PowerShell:\n\n```\nirm https://github.com/Podiom/Podiom/releases/latest/download/install.ps1 | iex\n```\n\nThe installer downloads the matching release binary, verifies its checksum,\ncan set up user-level autostart, and launches `podiom onboard`\n\nto check Claude\nand Codex and create your first agent. Linux releases are distro-neutral static\nbinaries.\n\nOpen [http://127.0.0.1:8787](http://127.0.0.1:8787) after onboarding. Updates are available from the CLI\nor web UI:\n\n```\npodiom update check\npodiom update apply --yes\n```\n\nPrerequisites: Go 1.26+ and Node 20+.\n\n```\n# Build the Vite web UI and both binaries into bin/ with a version stamp.\nmake build\n\n# Run the daemon in the foreground. It scaffolds ~/.podiom on first run.\n./bin/podiomd\n\n# In another shell, check that it is live.\n./bin/podiom status\n```\n\nOpen [http://127.0.0.1:8787](http://127.0.0.1:8787) for the web UI.\n\nFor frontend development with hot reload, run `npm run dev`\n\nin `web/`\n\n. Vite\nproxies API and WebSocket traffic to a running `podiomd`\n\n.\n\nEvery commit to `master`\n\npublishes a GitHub Release using the monotonic\n`v0.1.<run-number>`\n\nseries. The number identifies the release workflow run; it\ndoes not imply a calendar cadence.\n\n`podiomd`\n\nembeds the SPA and uses pure-Go SQLite, so it needs no external web\nassets or cgo at runtime:\n\n``` php\nmake cross    # linux/darwin/windows x amd64/arm64 -> bin/<os>-<arch>/\nmake package  # release archives in dist/ plus SHA256SUMS\n```\n\nAll runtime state lives under one overridable root. Running Podiom as a Home Assistant add-on or in a container is a packaging concern rather than a core rewrite:\n\n```\nPODIOM_HOME=/data/podiom ./bin/podiomd\n```\n\nThe web bind is configurable in `config.yaml`\n\nthrough `server.bind`\n\nand\n`server.port`\n\n. It defaults to `127.0.0.1:8787`\n\n; see\n[Configuration](/Podiom/Podiom/blob/master/docs/configuration.md).\n\n```\ncmd/podiom/     thin CLI client\ncmd/podiomd/    daemon: web server, scheduler, and core\ninternal/       core, adapters, execution, scheduling, config, store, server, client\nweb/            Svelte, Vite, TypeScript, and Tailwind SPA, built into podiomd\ndocs/           requirements, references, and integration contracts\n```\n\nRuntime state lives under `$PODIOM_HOME`\n\n, which defaults to `~/.podiom/`\n\n.\n\n[Requirements](/Podiom/Podiom/blob/master/docs/requirements/foundation.md), the authoritative foundation spec (v1.6)[CLI reference](/Podiom/Podiom/blob/master/docs/cli.md)[Configuration](/Podiom/Podiom/blob/master/docs/configuration.md)[Agents](/Podiom/Podiom/blob/master/docs/agents.md), durable named colleagues and their stored defaults[Git](/Podiom/Podiom/blob/master/docs/git.md), source control for projects[Sessions](/Podiom/Podiom/blob/master/docs/sessions.md), the durable conversation unit[SOUL.md generation](/Podiom/Podiom/blob/master/docs/soul-generation.md), agent identity files[Scheduling](/Podiom/Podiom/blob/master/docs/scheduling.md), recurring routines and timed work[Projects and Roadmap](/Podiom/Podiom/blob/master/docs/projects.md)[Goals](/Podiom/Podiom/blob/master/docs/goals.md), outcomes an agent plans, reviews, and reports back on[Agent tools](/Podiom/Podiom/blob/master/docs/agent-tools.md), what agents can do with Podiom itself[Toolset](/Podiom/Podiom/blob/master/docs/toolset.md), CLI tools agents install for themselves[Notifications](/Podiom/Podiom/blob/master/docs/notifications.md), how schedules, goals, and stuck agents reach you[Voice input](/Podiom/Podiom/blob/master/docs/voice-input.md), prompts spoken through OpenAI Whisper[Photo attachments](/Podiom/Podiom/blob/master/docs/photo-attachments.md), retained photos for agents to inspect[Security and logging](/Podiom/Podiom/blob/master/docs/security.md), permission modes, tokens, redaction, and run logs[Mobile apps](/Podiom/Podiom/blob/master/docs/mobile.md), the Capacitor iOS and Android clients[Home Assistant app](/Podiom/Podiom/blob/master/docs/home-assistant.md), Podiom as a Home Assistant add-on[WebSocket contract](/Podiom/Podiom/blob/master/docs/websocket.md), the browser-native`/api/ws`\n\nendpoint[Integration contracts](/Podiom/Podiom/blob/master/docs/integrations/README.md)\n\nPodiom is open source under the [MIT License](/Podiom/Podiom/blob/master/LICENSE). Contributions are\nwelcome. Read [CONTRIBUTING.md](/Podiom/Podiom/blob/master/CONTRIBUTING.md) for setup, validation, and pull\nrequest guidelines.", "url": "https://wpnews.pro/news/show-hn-podiom-durable-sessions-scheduling-and-goals-for-local-claude-codex", "canonical_source": "https://github.com/Podiom/Podiom", "published_at": "2026-08-30 13:08:34+00:00", "updated_at": "2026-08-30 13:52:18.575969+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["Podiom", "Claude Code", "OpenAI Codex", "Home Assistant"], "alternates": {"html": "https://wpnews.pro/news/show-hn-podiom-durable-sessions-scheduling-and-goals-for-local-claude-codex", "markdown": "https://wpnews.pro/news/show-hn-podiom-durable-sessions-scheduling-and-goals-for-local-claude-codex.md", "text": "https://wpnews.pro/news/show-hn-podiom-durable-sessions-scheduling-and-goals-for-local-claude-codex.txt", "jsonld": "https://wpnews.pro/news/show-hn-podiom-durable-sessions-scheduling-and-goals-for-local-claude-codex.jsonld"}}