# Send Timemap to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "timemap",
    "name": "Timemap",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/alexpolonsky/timemap",
    "canonicalUrl": "https://clawhub.ai/alexpolonsky/timemap",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/timemap",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=timemap",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/timemap.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "timemap",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T00:00:18.549Z",
      "expiresAt": "2026-05-17T00:00:18.549Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=timemap",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=timemap",
        "contentDisposition": "attachment; filename=\"timemap-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "timemap"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/timemap"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/timemap",
    "downloadUrl": "https://openagent3.xyz/downloads/timemap",
    "agentUrl": "https://openagent3.xyz/skills/timemap/agent",
    "manifestUrl": "https://openagent3.xyz/skills/timemap/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/timemap/agent.md"
  }
}
```
## Documentation

### Timemap - Tel Aviv & Haifa Venue History

Search historical entertainment, nightlife, and culture venues in Tel Aviv-Yafo and Haifa from timemap.co.il - a community-curated database mapping bars, cafes, clubs, cinemas, food venues, and performance spaces throughout the cities' history.

Data from timemap.co.il, a non-profit project by Reut Miryam Cohen and Amir Ozer - "a loving tribute to the places and people that made the cities we grew up in." Venues include opening/closing dates, locations, tags, user memories, and photos. This skill is an unofficial CLI wrapper.

### Quick Start

# Search for a venue (Hebrew or English)
python3 {baseDir}/scripts/timemap.py search "רוטשילד"
python3 {baseDir}/scripts/timemap.py search "Barby"

# See what was active in a specific year
python3 {baseDir}/scripts/timemap.py timeline 2010

# Get database statistics
python3 {baseDir}/scripts/timemap.py stats

### Commands

CommandDescriptionsearch <query>Search venues by name or address (Hebrew or English)filterFilter by --city, --tags, --year, --active-in, --opened, --closedvenue <id>Get full details for a specific venue (by ID or name)timeline <year>Show all venues that were active in a given yearnearby <lat> <lng>Find venues near coordinates (--radius in km, default 0.5)tags [tag]List all tags, or show venues with a specific tagcitiesList cities with venue countsstatsDatabase statistics (venues by city, tag, decade, status)memories <id>Show user memories for a specific venuerandomPick a random venue (prefers ones with memories/photos)

### Search Examples

# Search by name (Hebrew or English)
python3 {baseDir}/scripts/timemap.py search "טדי"
python3 {baseDir}/scripts/timemap.py search "Barby"

# Search by address
python3 {baseDir}/scripts/timemap.py search "רוטשילד"
python3 {baseDir}/scripts/timemap.py search "דיזנגוף"

# Get full details for a venue
python3 {baseDir}/scripts/timemap.py venue 192

# Find venues with user memories
python3 {baseDir}/scripts/timemap.py memories 253

### Filter Examples

# Filter by city
python3 {baseDir}/scripts/timemap.py filter --city tlv
python3 {baseDir}/scripts/timemap.py filter --city haifa

# Filter by tag
python3 {baseDir}/scripts/timemap.py filter --tags bar
python3 {baseDir}/scripts/timemap.py filter --tags food
python3 {baseDir}/scripts/timemap.py filter --tags cinema

# Venues that opened in a specific year
python3 {baseDir}/scripts/timemap.py filter --opened 2005

# Venues that closed in a specific year
python3 {baseDir}/scripts/timemap.py filter --closed 2010

# Venues active in a specific year
python3 {baseDir}/scripts/timemap.py filter --active-in 2008

# Combine filters
python3 {baseDir}/scripts/timemap.py filter --city tlv --tags bar --active-in 2010

### Timeline & Location Examples

# See what was happening in a specific year
python3 {baseDir}/scripts/timemap.py timeline 2005
python3 {baseDir}/scripts/timemap.py timeline 1995

# Find venues near coordinates (Rothschild Blvd area)
python3 {baseDir}/scripts/timemap.py nearby 32.0646 34.7731
python3 {baseDir}/scripts/timemap.py nearby 32.0646 34.7731 --radius 1.0

# Find venues near Florentin
python3 {baseDir}/scripts/timemap.py nearby 32.0566 34.7608 --radius 0.5

### Browse & Explore

# List all tags
python3 {baseDir}/scripts/timemap.py tags

# Show venues with a specific tag
python3 {baseDir}/scripts/timemap.py tags bar
python3 {baseDir}/scripts/timemap.py tags club

# List cities
python3 {baseDir}/scripts/timemap.py cities

# Database statistics
python3 {baseDir}/scripts/timemap.py stats

# Random venue (great for discovery)
python3 {baseDir}/scripts/timemap.py random

### Options Reference

OptionCommandsDescription--jsonallOutput in JSON format (agent-friendly)--limit Nsearch, filter, timeline, nearby, tagsMax results (default: 25 for terminal, unlimited for --json)--no-colorallDisable colored output (auto-detected for non-TTY)--freshallBypass cache and fetch fresh data from API--cityfilterFilter by city code (tlv, haifa)--tagsfilterFilter by tag (substring match)--yearfilterVenues that opened or closed in this year--active-infilterVenues that were active in this year--openedfilterVenues that opened in this year--closedfilterVenues that closed in this year--radiusnearbySearch radius in km (default: 0.5)

### City Codes

CodeCitytlvTel AvivhaifaHaifa

### Tags

7 main categories (matching the site's UI filters):

TagHebrewDescriptionbarבריםBar/pubfoodאוכלRestaurant/food venuecafeבתי קפהCafeclubמועדוניםNightclubcinemaבתי קולנועCinema/movie theaterlive_showsהופעותLive performanceslgbtqלהטב"קLGBTQ venue

Additional tags: dance_bar, lounge, wine_bar, restaurant

Use python3 {baseDir}/scripts/timemap.py tags to see current counts from live data.

### Workflow Example

# 1. Explore what Tel Aviv nightlife looked like in 2008
python3 {baseDir}/scripts/timemap.py timeline 2008

# 2. Filter just the bars
python3 {baseDir}/scripts/timemap.py filter --active-in 2008 --tags bar

# 3. Get details on an interesting venue
python3 {baseDir}/scripts/timemap.py venue "Barby"

# 4. Read user memories about it
python3 {baseDir}/scripts/timemap.py memories "Barby"

# 5. Find nearby venues
python3 {baseDir}/scripts/timemap.py nearby 32.0646 34.7731 --radius 0.5

### Notes

Community-curated: Historical data maintained by timemap.co.il community
No API key needed: Public API endpoint, no authentication required
Bilingual: Search works with Hebrew and English venue names
Caching: 24-hour local cache (one API call per day max, ~500KB)
Coordinates: Haversine formula for accurate distance calculations
Deleted venues filtered: Venues marked as deleted are automatically excluded
Color output: ANSI colors in terminal (respects NO_COLOR env var and --no-color flag)
User memories: Many venues have community-submitted memories and photos
Year estimates: Some opening/closing years are marked as estimates

### Agent Usage Patterns

For agent integration, always use --json flag for structured output:

# Search returns array of matching venues
python3 {baseDir}/scripts/timemap.py search "Barby" --json

# Timeline returns venues active in a year
python3 {baseDir}/scripts/timemap.py timeline 2010 --json

# Stats returns comprehensive database metrics
python3 {baseDir}/scripts/timemap.py stats --json

All commands support --json for machine-readable output with consistent structure:

{
  "ok": true,
  "command": "search",
  "count": 2,
  "venues": [...]
}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: alexpolonsky
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T00:00:18.549Z
- Expires at: 2026-05-17T00:00:18.549Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/timemap)
- [Send to Agent page](https://openagent3.xyz/skills/timemap/agent)
- [JSON manifest](https://openagent3.xyz/skills/timemap/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/timemap/agent.md)
- [Download page](https://openagent3.xyz/downloads/timemap)