Using agent-data-cli

Overview

INLINECODE0 is a local information center for multi-source content.

This skill is for discovering sources, searching channels, subscribing, syncing remote content, querying the local database, and running explicit interactions against news, RSS, social media, and financial data sources.

Use it for:

• - news
• social media
• financial data
• RSS feeds
• other sources that fit the source/channel/content model

This skill is operational, not explanatory. When the user's goal is clear, execute the CLI flow directly instead of only suggesting commands.

When to Use

Use this skill when the user wants to:

• - inspect available sources or channels
• discover remote content before subscribing
• subscribe to channels for ongoing tracking
• sync subscribed channels into the local database
• query locally stored content
• run explicit remote interactions on content refs

Do not use this skill for:

• - implementing or redesigning a source
• changing the command surface or core protocol
• free-form scraping outside the agent-data-cli model

Install From skills.sh

Install this skill directly from skills.sh:

CODEBLOCK0

Install And Repo Setup

If agent-data-cli is not present locally, install it first:

CODEBLOCK1

Then:

1. 1. Load the bundled skills from this repository's skills/ directory.
2. Use the repo root that contains pyproject.toml, cli/, and store/.
3. Treat source_workspace as external configuration. The default path is ./sources, and it is typically backed by the separate agent-data-hub workspace.
4. Execute commands from the repo root.

Always prefer:

CODEBLOCK2

Operating Rules

• - Translate natural language into the smallest correct CLI flow.
• Respect the command semantics exactly.
• Do not invent fallback behavior when a capability is unsupported.
• Do not hide remote side effects behind search or update.
• Do not turn content query into a remote search.
• Do not auto-subscribe unless the user's goal implies ongoing tracking.
• For content interact, require an explicit source and explicit refs.

Read references/command-semantics.md before using a command family you have not touched in the current session.

Read references/task-patterns.md when the user request is ambiguous and needs stable intent-to-command mapping.

Read references/result-reporting.md before reporting back after a multi-step run.

Usage Tips

Configure Proxy

INLINECODE17 uses one field with three states:

• - unset: use the user's current network environment
• INLINECODE18: force that proxy
• INLINECODE19: force direct connection and break CLI-level proxy inheritance

When one source needs its own proxy behavior, configure it explicitly:

CODEBLOCK3

If multiple sources should share one proxy, set the CLI-level default:

CODEBLOCK4

If a source needs to bypass an inherited CLI proxy, set that source to direct.

Inspect current source config:

CODEBLOCK5

Configure source_workspace

Core only loads sources that exist in the current workspace.

CODEBLOCK6

If the workspace contains data_hub, use it to discover, install, or uninstall official sources:

CODEBLOCK7

Schedule Updates with cron

Use a system scheduler when you want periodic local syncs. Keep the repo path explicit and append logs so the run can be inspected later:

CODEBLOCK8

If you need tighter OS integration, the same pattern can also be implemented with launchd or systemd.

Use --jsonl with jq or awk

For machine filtering, prefer --jsonl and pipe to shell tools:

CODEBLOCK9

The same pattern works for remote discovery:

CODEBLOCK10

Save Output with > and >>

Use > to overwrite a file and >> to append:

CODEBLOCK11

This is useful when you want to:

• - keep a snapshot for later analysis
• feed results into jq, awk, or other CLI tools
• accumulate multiple command outputs into one JSONL file

Execution Flow

1. 1. Classify the request as discovery, subscription, sync, local query, or remote interact.
2. Check whether the task should stay local or requires remote execution.
3. If needed, inspect source capability and config state before executing the main command.
4. Run the shortest correct command chain.
5. Report what was done, what was found, and what next action is now available.

Hard Boundaries

• - channel search is remote channel discovery only.
• INLINECODE37 is remote content discovery only and does not write to the database.
• INLINECODE38 is the only remote sync path that writes to the database.
• INLINECODE39 is local-only and never triggers remote work.
• INLINECODE40 is explicit remote side effect execution only.
• installing source runtime dependencies must stay out of the core project manifest; use uv pip install or source-local init.sh, not INLINECODE43

If a task does not fit these boundaries, say so directly instead of approximating.