← Back to Skills Marketplace
103
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install pulseflow
Description
Maintain a Markdown task dashboard with append-only AI work logs, syncing daily AI DONE TODAY and weekly usage panels via heartbeat or on-demand refresh.
Usage Guidance
What to check before installing PulseFlow:
- Review the code locally. The bundle includes many Node.js scripts that will read and write workspace files; inspect install_agent_log_rules.js, install_summary_crons.js, sync_ai_done.js, and rollover_now.js before running them.
- Confirm runtime dependencies: Node.js is required and the scripts expect an 'openclaw' CLI available on PATH (scripts call 'openclaw gateway usage-cost'). The registry metadata did not declare this binary — provide and test the CLI in a sandboxed environment first.
- Review and set config carefully: todo/system/config.json controls dashboardPath, historyDir, reportsDir and agentsFilePath. Ensure agentsFilePath does not point to any sensitive or system-level files because the skill will modify AGENTS.md to insert managed blocks.
- Cron installation: install_summary_crons.js can create template-driven cron jobs or other delivery hooks; use --dry-run and inspect generated output before enabling. Prefer manual scheduling until you confirm behavior.
- Credentials/usage access: querying usage via the 'openclaw' CLI will use whatever credentials that CLI is configured to use on the machine. If you don't want the skill to access live usage data, use AI_WORKLOG_USAGE_JSON to supply a local JSON file for testing.
- Test in an isolated workspace first: run scripts/validate_system.js and try init_system.js / sync_ai_done.js against a temporary directory to observe what files are created/changed.
Given the undeclared external CLI dependency and the script-driven file modifications, treat this bundle as functional but requiring careful review and controlled deployment.
Capability Analysis
Type: OpenClaw Skill
Name: pulseflow
Version: 1.2.1
PulseFlow is a task management and AI activity logging system designed for the OpenClaw environment. It automates the maintenance of a central dashboard (NOW.md) by aggregating append-only JSONL logs from various agents and fetching usage data via the 'openclaw' CLI. While the skill possesses significant capabilities—such as modifying other agents' configuration files (AGENTS.md) to inject logging rules and scheduling automated summary reports via 'openclaw cron'—these behaviors are explicitly documented, transparently implemented in the provided JavaScript scripts (e.g., scripts/install_agent_log_rules.js and scripts/install_summary_crons.js), and directly serve the stated purpose of the system. No evidence of data exfiltration, credential theft, or malicious prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's code implements a Markdown dashboard + append-only logs and heartbeat sync as described. However, the runtime calls an external CLI ('openclaw gateway usage-cost') to obtain usage summaries but the skill metadata declares no required binaries; Node.js is also assumed but not declared. The ability to modify agent AGENTS.md files (installAgentLogRules) and to create cron job templates (install_summary_crons) is coherent with the feature set, but these side-effects should be expected and reviewed.
Instruction Scope
SKILL.md and the scripts keep to the stated scope: reading config and sync-state, parsing per-agent JSONL logs, querying usage, rebuilding AI-derived Markdown sections, writing sync/rollover state, and archiving to month files. The runtime will write and rewrite the dashboard, create history files, and can inject managed rule blocks into AGENTS.md; those write actions are part of the intended scope.
Install Mechanism
There is no install spec (instruction-only in registry) but the bundle contains many executable Node.js scripts that will be run by callers. No external downloads are performed by the skill itself. Risk factor: scripts spawn a child process to run the 'openclaw' CLI (execFileSync), so the environment must provide that binary and its behavior/credentials are outside the skill's control.
Credentials
Registry lists no required environment variables or credentials, yet the code uses multiple optional env overrides (AI_WORKLOG_CONFIG, AI_WORKLOG_ROOT, AI_WORKLOG_USAGE_JSON, AI_WORKLOG_SKILL_DIR, AI_WORKLOG_TIMEZONE, AI_WORKLOG_*_REPORTS, AI_WORKLOG_ROLLOVER_STATE). Critically, usage data is obtained by invoking the local 'openclaw' CLI which will rely on local/OpenClaw credentials or environment to return usage — the skill does not request or document these credentials, creating a mismatch between declared and actual runtime needs. The skill will write to configured report directories and agent AGENTS.md files; those paths must be set in config and can point to sensitive locations if misconfigured.
Persistence & Privilege
The skill is not force-installed (always: false) and does not require elevated platform privilege flags. It does, however, write to workspace files: todo/NOW.md, todo/history/*.md, todo/system/*.json, reports/*.jsonl and it can upsert managed blocks in external AGENTS.md files and optionally install summary cron jobs. These persistent modifications are expected for this type of tool but are impactful and should be validated in a safe environment before enabling in production.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pulseflow - After installation, invoke the skill by name or use
/pulseflow - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
Hotfix: ignore placeholder checkboxes during rollover so empty section placeholders are not carried into the next day's TODAY list.
v1.2.0
Refine nightly flow to 00:05 previous-day report + 00:15 rollover, tighten report prompts so status-file blockers do not leak into task lists, and switch month history to week-grouped sections with weekly usage summaries.
v1.1.2
Hotfix: upsert monthly history day entries instead of blindly appending them, remove redundant monthly weekly usage summary, and simplify the history template.
v1.1.1
Hotfix: move daily close summary cron to 00:10 so it runs after rollover, and clarify that summary jobs supplement rather than replace rollover.
v1.1.0
Add optional summary cron installer, generic summary templates, config-driven notification settings, and a usage-panel blank-line fix.
v1.0.0
Initial public release: NOW.md dashboard, append-only AI logs, weekly usage panel, monthly archives, and daily rollover automation.
Metadata
Frequently Asked Questions
What is PulseFlow?
Maintain a Markdown task dashboard with append-only AI work logs, syncing daily AI DONE TODAY and weekly usage panels via heartbeat or on-demand refresh. It is an AI Agent Skill for Claude Code / OpenClaw, with 103 downloads so far.
How do I install PulseFlow?
Run "/install pulseflow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PulseFlow free?
Yes, PulseFlow is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does PulseFlow support?
PulseFlow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PulseFlow?
It is built and maintained by ayao99315 (@ayao99315); the current version is v1.2.1.
More Skills