Tines Builder

A Claude Code project for building, reviewing, and improving Tines automations. Use natural language to manage stories, credentials, and resources via Claude Code slash commands.

Setup

1. Copy .env.example to .env and fill in your credentials:

   TINES_TENANT_DOMAIN=yourorg.tines.com
   TINES_API_KEY=your_api_key
   TINES_TEAM_NAME=YourTeamName
   

2. Install dependencies:

   pip install -r requirements.txt

3. Open the project in Claude Code:

   claude

Usage

Use the built-in slash commands inside Claude Code:

Command	Description
/tines-review <story_id>	Review a story for quality and best-practice compliance
/tines-build <description>	Generate a new story JSON from a plain-English description
/tines-audit	Audit the tenant for unused credentials/resources and misconfigured stories
/tines-session	View, archive, or restore sessions

You can also ask Claude in plain English — e.g. "List all active stories" or "Export story 42 and check it for issues".

Scripts

Scripts are split into read (safe, run freely) and write (require confirmation) categories.

Read — scripts/read/

python scripts/read/list_stories.py
python scripts/read/get_story.py <id>
python scripts/read/export_story.py <id>
python scripts/read/list_actions.py <story_id>
python scripts/read/list_credentials.py
python scripts/read/list_resources.py

Write — scripts/write/ — Claude will always ask for confirmation before running these.

python scripts/write/import_story.py <file.json> --yes
python scripts/write/create_resource.py <name> <value> <type>
python scripts/write/update_resource.py <id> <new_value>
python scripts/write/delete_resource.py <id>

Sessions

Claude maintains a session in sessions/current/ to track context across conversations. At the start of each session it will offer to continue where you left off or start fresh. Archived sessions are stored in sessions/archive/.