feeding-cli

feeding-cli is the CLI-first toolkit for the feeding project. It ships with:

• a human-friendly terminal CLI
• a bundled MCP server entrypoint for AI clients
• a shared core for auth, session persistence, and REST API access

Install

From a local checkout:

cd feeding-tools
npm install
npm run build

Run the CLI directly:

node dist/cli.js auth whoami

If installed as a package, the executable is:

feeding-cli auth whoami

Start the bundled MCP server through the same executable:

feeding-cli mcp

CLI usage

Global flags:

• --json
• --api-base-url <url>
• --session-file <path>

Examples:

feeding-cli auth login --identifier wudi --password 'secret'
feeding-cli babies list
feeding-cli babies members --baby-id 1
feeding-cli records list --baby-id 1 --date 2026-04-30
feeding-cli records create --baby-id 1 --type formula --amount 120 --unit ml --timestamp 2026-04-30T10:00:00Z

Environment variables:

• FEEDING_API_BASE_URL
• FEEDING_REQUEST_TIMEOUT_MS
• FEEDING_DEBUG
• FEEDING_SESSION_FILE

Default CLI session file:

• ~/.feeding-cli/session.json

MCP usage

This package also contains a stdio MCP server entrypoint:

node dist/index.js

If you prefer an npx-friendly MCP config, use:

{
  "command": "npx",
  "args": ["-y", "feeding-cli", "mcp"],
  "env": {
    "FEEDING_API_BASE_URL": "http://127.0.0.1:8000"
  }
}

Recommended MCP environment variables:

• FEEDING_API_BASE_URL
• FEEDING_MCP_SESSION_FILE
• FEEDING_MCP_REQUEST_TIMEOUT_MS
• FEEDING_MCP_DEBUG

The MCP tool names are prefixed with feeding_, for example:

• feeding_auth_whoami
• feeding_list_babies
• feeding_create_feeding_record

Notes

• The CLI is the primary interface for humans and shell automation.
• The bundled MCP server is retained for Codex, Claude, and other AI clients.