freedcamp-agent-skill_skill

Overview

This skill manages Freedcamp tasks, projects, groups, comments, notifications, and task lists using HMAC-SHA1 API credentials. It provides a CLI that returns JSON output only, making it suitable for automation and agent workflows. Authentication uses an API Key and API Secret supplied via environment variables or injected config.

How this skill works

The CLI calls the Freedcamp REST API (v1) with HMAC-SHA1 signed requests and prints JSON to stdout. It caches session data locally and refreshes on 401 errors. Commands support listing and resolving groups/projects, paginated task queries with filters, single-task retrieval (including comments and files), creation and updates, commenting, notifications, and task list operations.

When to use it

• Automate reading or syncing Freedcamp tasks and projects from other systems.
• Run agent-driven workflows that need structured JSON responses from Freedcamp.
• Create, update, or comment on tasks programmatically with secure credentials.
• Fetch notifications and mark them read as part of an inbox automation.
• Enumerate task lists or app metadata for discovery and mapping.

Best practices

• Provide FREEDCAMP_API_KEY and FREEDCAMP_API_SECRET via environment variables or injected agent config to avoid secrets in logs.
• Use groups-projects to resolve project_name to project_id before calling other commands to avoid ambiguous IDs.
• Use the --all flag or pagination (limit/offset) for large task sets; limit is 200 per page.
• Pass comments as --text for automatic <p> wrapping or use --html to supply raw HTML.
• Respect app_name values when commenting; use the supported app list to target the correct app.

Example use cases

• List all tasks in a project with status filters and export results as JSON for reporting.
• Create a new task by project name from an automated intake form and attach it to a task list.
• Fetch a task with its comments and files for a support bot to summarize conversation history.
• Poll notifications and mark processed items as read to maintain an agent-managed inbox.
• Resolve groups and projects to build a project directory for a migration or backup process.